エージェント型AI > モデルコンテキストプロトコル > エージェントコーディング環境をMCPサーバーに接続する

エージェントコーディング環境をMCPサーバーに接続する¶

DataRobot MCPサーバーをCursor、Claude Desktop、VS Codeなどの標準的なエージェントコーディング環境に接続して、それらの環境のAIアシスタントがMCPツール、プロンプト、リソースを探索して呼び出せるようにすることができます。これにより、IDEやチャットクライアントから直接DataRobotの機能（プロジェクト、デプロイ、予測、サードパーティツールなど）を利用できます。

このガイドでは、ローカルで実行している、またはDataRobotにデプロイされているMCPサーバーを使用するように各クライアントを設定する方法について説明します。この方法は、MCPサーバーがDataRobot Agentic StarterのテンプレートまたはDataRobot MCP Templateのどちらに由来するかに関わらず適用されます。

MCPサーバーとエージェントアプリケーションの比較

このページでは、MCPクライアント（Cursor、Claude Desktop、VS Code）をMCPサーバーに接続する方法について説明します。 MCPサーバーをDataRobotのエージェントワークフロー（例：Agentic StarterテンプレートのLangGraphエージェント）に統合する方法については、MCPサーバーを使用したツールの統合を参照してください。

前提条件¶

コーディング環境を設定する前に、以下が揃っていることを確認します。

実行中のMCPサーバー（ローカルまたはデプロイ済み）：
ローカル
- DataRobot Agentic Starterのテンプレート（デフォルトポートは9000）またはDataRobot MCP Template（デフォルトポートは8080）を介して起動されたMCPサーバー。
- ベースURL（例：http://localhost:9000/mcpまたはhttp://localhost:8080/mcp）。
デプロイ完了
- DataRobotにデプロイされたMCPサーバー。MCPエンドポイントのURL（例：https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp）が必要です。
- ベースURL（例：https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp）。
エンドポイントと認証
"Authorization": "Bearer "（MCPサーバーでの認証に必要）
"x-datarobot-api-token": ""（ツールの実行に必要）

デプロイ済みMCPエンドポイントの特定

デプロイ済みMCPサーバーのエンドポイントを特定するには：

DataRobot MCP Templateの場合、デプロイ後にtask infra:infoを実行するか、Pulumi/outputステップでMCP_SERVER_MCP_ENDPOINTを確認します。
Agentic Starterのテンプレートの場合、デプロイ出力にMCPサーバーのエンドポイントが含まれます。そこに表示されているURLをクライアントに使用します。

エンドポイントリファレンス¶

コンテキスト	基本URL	備考
Agentic Starter（ローカル）	`http://localhost:9000/mcp`	デフォルトポートは9000。変更したい場合は`MCP_SERVER_PORT`を設定します。
MCPテンプレート（ローカル）	`http://localhost:8080/mcp`	デフォルトポートは8080。変更したい場合は`MCP_SERVER_PORT`を設定します。
DataRobotへのデプロイ	`https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp`	デプロイ出力の正確なURLを使用します。

Cursor¶

CursorはHTTP経由でMCPサーバーに接続できます。 MCPサーバーのHTTP対応エンドポイントを指すurlエントリーを使用します。

Cursor MCPのドキュメント

Cursorの現在のMCPオプションについては、CursorのMCPドキュメントを参照してください。

設定ファイルの場所¶

プロジェクト固有：<project-root>/.cursor/mcp.json
グローバル：~/.cursor/mcp.json

設定例¶

ローカルMCPサーバー（ポート8080のDataRobot MCPテンプレート）：

.cursor/mcp.json (local)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

ローカルMCPサーバー（ポート9000のDataRobot Agentic Starter）：

.cursor/mcp.json (Agentic Starter local)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "http://localhost:9000/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

デプロイされたMCPサーバー（お使いのエンドポイントに置き換え、必要に応じて、サーバーでサポートされている認証を追加します）：

.cursor/mcp.json (deployed)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

適用と確認¶

接続を確認するには：

mcp.jsonを正しい場所に保存します。
Cursorを再起動（またはウィンドウを再読み込み）します。
ChatまたはComposerで、AIにDataRobot MCPサーバーのツールを一覧表示または使用するように依頼します。

Claude Desktop¶

Claude DesktopはHTTP経由でリモートMCPサーバーに接続できます。 claude_desktop_config.jsonでMCPサーバーを設定します。

Claude Desktop MCPのドキュメント

Claude Desktopの現在のMCPオプションについては、Claude DesktopのMCPドキュメントを参照してください。

設定ファイルの場所¶

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

設定例¶

ローカルMCPサーバー（ポート8080のDataRobot MCPテンプレート）：

claude_desktop_config.json (local)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

ローカルMCPサーバー（ポート9000のDataRobot Agentic Starter）：

claude_desktop_config.json (Agentic Starter local)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "http://localhost:9000/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

デプロイされたMCPサーバー（お使いのエンドポイントに置き換え、必要に応じて、サーバーでサポートされている認証を追加します）：

claude_desktop_config.json (deployed)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

デプロイに認証が必要な場合は、Claude DesktopとMCPサーバーでサポートされている適切なヘッダーまたはトークンメカニズムを追加します（例：環境変数や設定フィールド。Claude Desktopのドキュメントとサーバーのドキュメントを確認してください）。

適用と確認¶

接続を確認するには：

claude_desktop_config.jsonを正しいパスに保存します。
Claude Desktopを再起動します。
新しい会話で、ClaudeにDataRobot MCPサーバーのツールやリソースを使用するように依頼します。

Claude Desktop MCPのデバッグ

macOSでは、MCP関連のログは多くの場合、~/Library/Logs/Claude/（例：mcp*.log）の下にあります。これを接続または認証の問題のトラブルシューティングに使用します。

VS Code¶

VS Code（GitHub Copilotと連携）には、組み込みのMCPクライアントサポートが含まれています。 Copilot設定またはVS Code設定でMCPサーバーを設定することにより、HTTP経由でMCPサーバーに接続できます。

VS Code Copilot MCPのドキュメント

VS Codeの現在のMCPオプション、設定キー、セキュリティに関する注意事項については、VS CodeでのMCPサーバーの使用を参照してください。

設定ファイルの場所¶

正確な設定キーとファイルの場所については、VS CodeでのMCPサーバーの使用を参照してください。ユーザー設定は、設定 → Copilot → MCPサーバーから、またはユーザーやワークスペースのsettings.jsonにMCPサーバーエントリーを追加することで行えます。

設定例¶

ローカルMCPサーバー（ポート8080のDataRobot MCPテンプレート）：

VS Code / Copilot MCP config (local, port 8080)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

ローカルMCPサーバー（ポート9000のDataRobot Agentic Starter）：

VS Code / Copilot MCP config (Agentic Starter local)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "http://localhost:9000/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

デプロイされたMCPサーバー（お使いのエンドポイントに置き換え、必要に応じて、サーバーでサポートされている認証を追加します）：

VS Code / Copilot MCP config (deployed)

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp",
      "headers": {
        "Authorization": "Bearer <DR_API_KEY>",
        "x-datarobot-api-token": "<DR_API_KEY>"
      }
    }
  }
}

デプロイされたサーバーにトークンが必要な場合は、HTTPヘッダーまたはVS Code CopilotとMCPサーバーでサポートされているメカニズムを使用して認証を設定します。資格情報漏洩のリスクを減らすため、URLやクエリーパラメーターでトークンを渡さないようにしてください。正確な設定については、VS CodeでのMCPサーバーの使用とサーバーのドキュメントを参照してください。

適用と確認¶

MCPサーバーの設定を正しい場所（設定 → Copilot → MCPサーバーまたはsettings.json）に保存します。
必要に応じて、VS Codeまたはウィンドウを再読み込みします。
Copilot Chatで、AIにDataRobot MCPサーバーのツールを一覧表示または使用するように依頼して、接続を確認します。

トラブルシューティング¶

クライアントがMCPサーバーに接続できない¶

症状：IDEまたはClaudeからMCPサーバーが利用できないことが報告されるか、ツールが表示されない。

解決方法：

MCPサーバーが実行されていることを確認します。
ローカル：curl -i http://localhost:9000/またはcurl -i http://localhost:8080/を実行します（ローカルのMCPサーバー設定に合わせてポートを調整してください）。応答が正常であれば、サーバーは稼働中です。
デプロイ済み：デプロイ出力の正確なURLを使用して、curl -i <your-mcp-endpoint-url>を実行します。サーバーが認証を必要とする場合、ベアラートークンやその他のヘッダーを渡す必要が生じる可能性があります。デプロイのドキュメントを参照してください。応答が正常であれば、サーバーは稼働中です。
URLとパスの確認：クライアントとサーバーで必要な正確なベースURLとパス（/mcpなど）を使用します。
ファイアウォールとネットワークアクセスの確認：デプロイ済みサーバーの場合、ネットワークでDataRobotホストへのアウトバウンドHTTPSが許可されていることを確認します。

クライアントにツールが表示されない¶

症状：接続は問題なさそうだが、クライアントにMCPツールが一覧表示されない。

解決方法：

MCP設定を変更した後、クライアント（Cursor、Claude Desktop、またはVS Code）を再起動します。
クライアントおよびMCPサーバーのログにエラーがないか確認します（例：Cursor: Output → MCP Logs、Claude: ~/Library/Logs/Claude/）。接続に成功すると、ツールの登録と可用性に関する情報を含むMCPサーバーのログが表示されます。

認証エラー¶

症状：デプロイされたMCPサーバーにリクエストすると、401などが返される。

解決方法：

デプロイされたサーバーの認証要件（ベアラートークンなど）を確認します。
クライアントが正しいトークンや資格情報（環境変数または拡張機能の設定）で構成されていることを確認します。
DataRobotのデプロイの場合、DATAROBOT_API_TOKEN（またはサーバーで使用される同等のもの）が有効であり、デプロイへのアクセス権があることを確認します。

その他のリソース¶

MCPサーバーを使用したツールの統合 — DataRobotのエージェントワークフロー（LangGraphエージェントなど）からMCPサーバーを使用します。
DataRobot MCP Template — DataRobotと連携するスタンドアロンMCPサーバーを構築およびデプロイします。
DataRobot MCP Template — MCPクライアントの設定 — テンプレートリポジトリからのクライアント設定の詳細。
DataRobot Agentic Starterのテンプレート — MCPサーバーを含む完全なエージェントアプリケーション。
Model Context Protocol — 公式のMCP仕様。