Claude CodeにMCPサーバーを追加する方法（ステップバイステップガイド）

はじめに

Claude Code は、コーディングを支援するだけでなく、コードベース全体を分析し、複数ステップの変更を計画し、ファイルを横断してタスクを実行するように設計されています。しかし、Claude Code単体では、まだローカル環境に限定されています。現代の開発ワークフローでは、以下との連携が不可欠です。

• リポジトリ
• データベース
• API
• 社内ツール

ここで MCP（Model Context Protocol） サーバーが登場します。MCPを使用すると、Claude Codeは外部システムに接続し、コード編集以外の操作を実行できるようになり、次のようなワークフローが可能になります。

• コード変更のプッシュ
• データベースのクエリ
• コマンドの実行
• サービスのトリガー

つまり、MCPはClaude Codeをコーディングツールから 完全な実行エージェントに変えます。しかし、Claude CodeでMCPサーバーをセットアップするのは、特に初めての場合、混乱を招く可能性があります。このガイドでは、 Claude CodeにMCPサーバーを追加する方法を正確にステップバイステップで説明します。

始める前に必要なもの

MCPサーバーをClaude Codeに追加する前に、以下の準備が整っていることを確認してください。

これらを事前に設定しておくことで、時間の節約になり、一般的な設定の問題を防ぐことができます。

1. Claude Codeのインストールと動作確認

Claude Codeがご使用の環境に正しくインストールされ、動作していることを確認してください。

以下のことができる必要があります：

• コードベースを開いて操作できること
• コマンドやプロンプトを実行できること
• 構成設定にアクセスできること

Claude Codeが完全にセットアップされていない場合は、まずそちらを完了してください。

2. MCPサーバー（ローカルまたはホスト型）

Claude CodeにはMCPサーバーがデフォルトでは含まれていないため、接続する必要があります。これは以下のいずれかです：

• ご自身のマシンで動作している ローカルMCPサーバー
• ホスト型の ホスト型MCPサーバー （社内またはサードパーティ製）

一般的なMCPサーバーには以下が含まれます：

• GitHub（リポジトリ用）
• ファイルシステム（ファイル操作用）
• PostgreSQL（データベース用）
• REST API（サービス用）

まずは、ユースケースに合ったサーバーを1つ選びましょう。

3. 認証情報とアクセス

ほとんどのMCPサーバーでは認証が必要です。次のいずれかが必要になる場合があります。

• APIキー
• アクセストークン
• データベース認証情報

次の点を確認してください。

• 認証情報が有効であること
• 権限が適切に設定されていること
• 機密データが安全に保管されていること

4. 明確なユースケース

MCPサーバーを追加する前に、Claude Codeに何をさせたいかを決めましょう。

例：

• コードの管理 → GitHub MCP
• データのクエリ → データベースMCP
• サービスの呼び出し → API MCP

これにより、不要な複雑さを避けることができます。

5. テストのための安全な環境

MCPサーバーは、 開発環境またはステージング環境 でまず設定するのが最適です。

これにより、以下のことが可能になります。

• 統合を安全にテストする
• リスクなく問題をデバッグする
• 権限とワークフローを検証する

すべてが機能するようになったら、その設定を本番環境に拡張できます。

Claude CodeにおけるMCPの仕組み

何かを設定する前に、MCPがClaude Codeとどのように統合されるかを理解しておくと役立ちます。Claude Codeは以下の役割を担います。

• コードベースを理解する
• タスクを計画する
• 実行するアクションを決定する

MCPサーバーは以下の役割を担います。

• それらのアクションを実行する
• 外部システムと連携する
• 結果をClaude Codeに返す

フローの仕組み

1. Claude Codeでタスクを定義します
2. Claude Codeは、どのツール（MCPサーバー）が必要かを判断します
3. MCPサーバーがリクエストを実行します
4. 結果が返され、次のステップに利用されます

例：

• 「失敗しているAPIを修正してデプロイする」
  • Claudeがコードを分析します
  • MCPを使用してテストを実行します
  • MCPを使用して変更をプッシュします
  • MCPを使用してデプロイをトリガーします

ステップバイステップ：Claude CodeにMCPサーバーを追加する

実際にMCPサーバーを追加して設定する方法を見ていきましょう。

ステップ1：MCPサーバーをセットアップする

Claude Codeに追加する前に、MCPサーバーが稼働している必要があります。

サーバーによっては、セットアップに以下が含まれる場合があります。

• 依存関係のインストール
• サービスをローカルで実行
• 環境変数の設定

例（NodeベースのMCPサーバー）：

npm installnpm start

またはDockerを使用する：

docker run <mcp-server-image>

確認事項：

• The server is running
• You know the endpoint (URL/port)
• Required credentials are configured

Step 2: Open Claude Code Configuration

In Claude Code:

• Navigate to your configuration file or settings panel
• Locate the section for tooling / MCP / integrations

(Exact location may vary depending on setup)

Step 3: Add MCP Server Entry

You’ll now add a configuration entry that tells Claude Code how to connect to the MCP server.

Example Configuration

{
  "mcpServers": [
    {
      "name": "github",
      "type": "http",
      "url": "http://localhost:3000",
      "auth": {
        "type": "bearer",
        "token": "YOUR_API_TOKEN"
      }
    }
  ]
}

What Each Field Means

• name → Identifier used by Claude Code
• type → Connection type (HTTP/local)
• url → MCP server endpoint
• auth → Authentication details

Step 4: Configure Authentication

If your MCP server requires authentication:

• Add API keys or tokens
• Ensure permissions are correct
• Avoid exposing secrets in plain text

Depending on the server, this could include:

• Bearer tokens
• API keys
• OAuth credentials

Step 5: Test the MCP Server

Once configured, test the integration.

Try prompts like:

• “List repositories from GitHub”
• “Run tests in this project”
• “Fetch data from database”

If everything is working:

• Claude Code will call the MCP server
• You’ll receive a valid response

If not:

• Check logs
• Verify credentials
• Confirm endpoint is reachable

Common Issues and Fixes

1. MCP Server Not Reachable

Problem: Claude Code cannot connect

Fix:

• Ensure server is running
• Check URL/port
• Verify network access

2. Authentication Errors

Problem: Access denied or invalid token

Fix:

• Regenerate credentials
• Check permission scope
• Ensure correct auth format

3. Permission Failures

Problem: Server responds but actions fail

Fix:

• Verify access levels
• Check service permissions
• Adjust roles as needed

4. Configuration Errors

Problem: MCP server not recognized

Fix:

• Validate JSON syntax
• Ensure required fields exist
• Restart Claude Code if needed

Best Practices for Adding MCP Servers to Claude Code

Once you’ve connected MCP servers to Claude Code, the focus should shift to making your setup secure, reliable, and maintainable.

1. Start with Minimal Permissions

Avoid giving MCP servers unrestricted access.

Instead:

• Use scoped tokens
• Grant only required permissions
• Expand access gradually

This is especially important for:

• Production databases
• Deployment systems
• Internal APIs

2. Use Separate Environments

Always test MCP integrations in development or staging environments before production.

This allows you to:

• Validate configurations safely
• Debug without impacting live systems
• Refine workflows

Once stable, replicate the setup in production with stricter controls.

3. Validate Before Executing Critical Actions

Claude Code can execute multi-step workflows, but not all actions should run unchecked.

Best practices:

• Review planned changes
• 機密性の高いワークフローに検証ステップを追加する
• リスクの高い環境での完全な自律性を避ける

4. MCPの使用状況を監視する

Claude Codeが複数のシステムと連携する場合、可視性が鍵となります。

追跡対象:

• どのMCPサーバーが使用されているか
• どのようなアクションが実行されているか
• ワークフローが時間の経過とともにどのように動作するか

これは以下に役立ちます:

• デバッグ
• 監査
• 信頼性の向上

5. 設定を整理し、スケーラブルに保つ

MCPサーバーを追加するにつれて、複雑さが増します。

これを管理するには:

• 一貫した命名規則を使用する
• 設定を明確に整理する
• 連携を文書化する

これにより、システムの進化に合わせてセットアップの保守性が維持されます。

本番環境での考慮事項: MCPワークフローのスケーリング

1つのMCPサーバーのセットアップは簡単です。しかし、複数のMCPを活用したワークフローを本番環境で運用するのは容易ではありません。

1. 複数の連携の管理

利用が拡大するにつれて、チームは複数のMCPサーバーを連携させます。

• GitHub
• データベース
• API
• 社内ツール

構造がないと、これは以下の問題を引き起こします。

• 分散した設定
• 一貫性のないアクセス制御
• 管理しにくいワークフロー

2. ガードレールの適用

Claude Codeは、複数のシステムにわたって強力なアクションを実行できます。

適切な制御がないと、これは以下のリスクをもたらします。

• 意図しない変更
• 不正アクセス
• システムの不安定化

チームには以下が必要です。

• ロールベースのアクセス制御
• アクションレベルの制限
• 明確な実行境界

3. 可観測性とデバッグ

可視性がないと、MCPワークフローのデバッグは困難になることがあります。

理解すべき点:

• Claude Codeが試みたこと
• どのMCPサーバーがリクエストを処理したか
• どこで障害が発生したか

可観測性がないと、トラブルシューティングは遅くなり、信頼性が低下します。

4. モデル、コスト、パフォーマンスの管理

MCPワークフローは基盤となるモデルに依存しています。

大規模な運用では、チームは以下を管理する必要があります:

• モデル選択 (レイテンシー vs 品質)
• 複数回の実行におけるコスト
• パフォーマンスのボトルネック

これには一元的な管理が必要です。

TrueFoundryによる本番環境でのMCPワークフローの実行

Claude Codeを使ってMCPサーバーをローカルで動作させるのは比較的簡単です。しかし、同じワークフローを複数のチーム、環境、本番システムで実行しようとすると、本当の課題が始まります。

その段階で、チームは通常、いくつかの問題に直面します:

• 認証情報が設定や環境に散在している
• エージェントが実行できるアクションに対する明確な制御がない
• MCP呼び出し全体での障害のデバッグが困難になります
• モデルの使用状況やコストの追跡、最適化が困難です

ここでTrueFoundryのようなプラットフォームが、単なるアドオンとしてではなく、 AI駆動型ワークフローのコントロールプレーンとして役立ちます。。

MCPアクセスと認証情報の一元化

ほとんどの環境で、MCPサーバーはAPIキー、トークン、またはデータベース認証情報を必要とします。これらは多くの場合、次のようになります。

• 設定ファイルにハードコードされている
• 環境変数に保存されている
• 環境間で一貫性なく管理されている

TrueFoundryを使用すると、これらの認証情報の管理とアクセス方法を一元化できるため、

• ローカルの設定ファイルにシークレットが公開されない
• 開発、ステージング、本番環境全体でアクセスが一貫している
• ローテーションや更新の処理が容易になる

エージェントに許可される操作の定義

Claude Codeは、コードのプッシュ、データのクエリ、コマンドの実行など、実際のアクションを実行できます。

本番環境では、すべてのエージェントに無制限のアクセスを許可したくはないでしょう。

TrueFoundryを使用すると、以下を定義できます。

• エージェントがどのMCPサーバーを使用できるか
• どのようなアクションが許可されているか（読み取りと書き込み、制限されたスコープなど）
• 承認や検証が必要な場合

これにより、エージェントが次のような状況に陥るのを防ぐことができます。

• 機密性の高いシステムを変更する
• 意図しないワークフローを実行する
• 元に戻すのが難しい変更を引き起こす

MCPコール全体の可観測性

MCPワークフローで問題が発生した場合、最も難しいのは どこで失敗したかを特定することです。。

原因は次のうちどれでしょうか？

• モデルの推論でしょうか？
• MCPサーバーコールでしょうか？
• ダウンストリームシステムでしょうか？

TrueFoundryは以下を可視化します。

• エージェントの実行ステップ
• MCPサーバーとのインタラクション
• 入力、出力、エラー

これにより、以下がはるかに容易になります。

• 問題のデバッグ
• 動作の監査
• ワークフローを継続的に改善する

大規模なモデルとコストの管理

Claude Codeは基盤となるモデルに依存しており、MCPワークフローでは繰り返し呼び出しが行われることがよくあります。

利用が増えるにつれて、チームは次のことを行う必要があります。

• 複数のモデル間でリクエストをルーティングする
• コストとパフォーマンスのバランスを取る
• 複数のチーム間で利用状況を監視する

TrueFoundryは、次のことを行うための一元的な方法を提供します。

• どのモデルが使用されるかを制御する
• ルーティング戦略を最適化する
• コストを追跡し、管理する

ローカルセットアップからチーム全体のワークフローへ

シンプルなセットアップとして始まるものは次のとおりです。

「MCPサーバーを追加 → タスクを実行」

すぐに次のようになります。

「複数のエージェント → 複数のMCPサーバー → 複数の環境」

TrueFoundryは、一貫した方法を提供することで、これを標準化するのに役立ちます。

• 統合を設定する
• ポリシーを適用する
• 複数のチーム間でワークフローをスケールさせる

MCPにより、Claude Codeはシステムとやり取りできるようになります。
TrueFoundryは、これらのやり取りが 制御され、監視可能で、本番環境に対応していることを。

結論

MCPサーバーをClaude Codeに追加することで、強力なコーディングツールから、システムと実際に連携し、実際のワークフローを実行できる、はるかに有用なエージェントへと進化させることができます。

適切な設定を行うことで、Claude Codeはコード編集の枠を超えて、以下のことが可能になります。

• リポジトリに変更をプッシュする
• データベースをクエリする
• APIを呼び出す
• コマンドを実行し、結果を検証する

しかし、これらのワークフローをローカルでの実験を超えて利用し始めると、課題は変化します。もはやMCPサーバーを機能させることだけが問題ではなく、 これらのやり取りが環境、システム、チーム間でどのように行われるかを管理することです。

その点で、TrueFoundryのようなプラットフォームが重要になります。これらは、MCPベースのワークフローに構造をもたらし、アクセス制御、可視性、スケーリングを処理することで、チームがClaude Codeのようなツールを本番環境で確実に使用できるようにします。最終的に、MCPは機能を実現する鍵となりますが、真の価値は、どれだけうまく 実世界のシステムでそれらの機能を運用し、拡張できるかにあります。