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

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

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

このガイドでは、ローカルで実行している、またはDataRobotにデプロイされているMCPサーバーを使用するように各クライアントを設定する方法について説明します。次のいずれかのMCP接続オプションに適用されます。

DataRobot Agentic Starterのテンプレート（datarobot-agent-application）を使用してデプロイされたMCPサーバー。
DataRobot MCPのテンプレート（af-component-datarobot-mcp）を使用してデプロイされたスタンドアロンMCPサーバー。
DataRobot Global MCPによって実装されたMCPサーバー。

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

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

DataRobot Global MCPの使用¶

DataRobot Global MCPは、DataRobotインスタンスに自動的にデプロイされるサービスであり、エージェントワークフローはこのサービスを使用してツールにアクセスできます。

利用可能なツール

DataRobot Global MCPでは現在、予測AI向けのツールのみがサポートされています。この制限は、今後のリリースで解除される予定です。

設定¶

DataRobot Global MCPでは、リクエストの認証にAPIキーが必要です。 DataRobotのUIでユーザーメニューを開き、APIのキーとツールを選択すると、APIキーを取得できます。詳細については、APIキー管理を参照してください。

APIキーを取得したら、DataRobot Global MCPエンドポイントを使用するようにMCPクライアントを設定します。以下のタブで、MCPクライアントに対応する手順を参照してください。

CursorClaude DesktopVS Code

.cursor/mcp.json

{
  "mcpServers": {
    "datarobot-mcp": {
      "url": "https://{DATAROBOT_URL}/api/v2/genai/globalmcp/mcp",
      "headers": {
        "Authorization": "Bearer <DATAROBOT_API_TOKEN>"
      }
    }
  }
}

接続を確認するには、.cursor/mcp.jsonを適切な場所に保存し、Cursorを再起動するかウィンドウを再読み込みした後、ChatまたはComposerで、AIにDataRobot MCPサーバーのツールを一覧表示または使用するように依頼します。

claude_desktop_config.json

{
    "mcpServers": {
        "datarobot-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote@latest",
                "https://{DATAROBOT_URL}/api/v2/genai/globalmcp/mcp",
                "--header",
                "Authorization: ${AUTH_HEADER}",
                "--transport",
                "http"
            ],
            "env": {
                "AUTH_HEADER": "Bearer <DATAROBOT_API_TOKEN>"
            }
        }
    }
}

接続を確認するには、claude_desktop_config.jsonを適切な場所に保存し、Claude Desktopを再起動した後、ClaudeにDataRobot MCPサーバーのツールを使用するように依頼します。

.vscode/mcp.json

{
  "servers": {
    "datarobotMcp": {
      "type": "http",
      "url": "https://{DATAROBOT_URL}/api/v2/genai/globalmcp/mcp",
      "headers": {
        "Authorization": "Bearer <DATAROBOT_API_TOKEN>"
      }
    }
  }
}

接続を確認するには、.vscode/ディレクトリまたはユーザープロフィール（コマンドパレットのMCP: Open User Configuration）に.vscode/mcp.jsonを保存し、プロンプトが表示されたらウィンドウを再読み込みします。その後、Copilot ChatでAIに、DataRobot MCPサーバーのツールを一覧表示または使用するように依頼します。

スタンドアロンMCPサーバーの使用¶

自身のインフラストラクチャにデプロイしたスタンドアロンMCPサーバーを使用することもできます。スタンドアロンMCPサーバーを使用するには、そのエンドポイントを使用するようにMCPクライアントを設定する必要があります。

前提条件¶

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

実行中のMCPサーバー（ローカルまたはデプロイ済み）：
ローカル
- DataRobot Agentic Starterのテンプレート（デフォルトポート9000）またはDataRobot MCPのテンプレート（デフォルトポート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 <DATAROBOT_API_TOKEN>" (required for authentication with the MCP server)
"x-datarobot-api-token": "<DATAROBOT_API_TOKEN>" (required for tool execution)

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

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

DataRobot MCPのテンプレートについては、デプロイ後に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を使用します。

環境設定¶

MCPサーバーのエンドポイントを使用するようにMCPクライアントを設定できます。以下のタブで、MCPクライアントに対応する手順を参照してください。

CursorClaude DesktopVS Code

Cursor MCPのドキュメント

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

設定ファイルの位置：

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

ポート9000でDataRobot Agentic Starterを使用するローカルMCPサーバーの場合：

.cursor/mcp.json (Agentic Starter local)

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

ポート8080でDataRobot MCPのテンプレートを使用するローカルMCPサーバーの場合：

.cursor/mcp.json (local)

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

デプロイ済みMCPサーバーの場合：

.cursor/mcp.json (deployed)

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

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

ポート9000でDataRobot Agentic Starterを使用するローカルMCPサーバーの場合：

claude_desktop_config.json (Agentic Starter local)

{
    "mcpServers": {
        "datarobot-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote@latest",
                "http://localhost:9000/mcp",
                "--header",
                "Authorization: ${AUTH_HEADER}",
                "--header",
                "x-datarobot-api-token: ${DR_API_TOKEN}",
                "--transport",
                "http"
            ],
            "env": {
                "AUTH_HEADER": "Bearer <DATAROBOT_API_TOKEN>",
                "DR_API_TOKEN": "<DATAROBOT_API_TOKEN>"
            }
        }
    }
}

ポート8080でDataRobot MCPのテンプレートを使用するローカルMCPサーバーの場合：

claude_desktop_config.json (local)

{
    "mcpServers": {
        "datarobot-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote@latest",
                "http://localhost:8080/mcp",
                "--header",
                "Authorization: ${AUTH_HEADER}",
                "--header",
                "x-datarobot-api-token: ${DR_API_TOKEN}",
                "--transport",
                "http"
            ],
            "env": {
                "AUTH_HEADER": "Bearer <DATAROBOT_API_TOKEN>",
                "DR_API_TOKEN": "<DATAROBOT_API_TOKEN>"
            }
        }
    }
}

デプロイ済みMCPサーバーの場合：

claude_desktop_config.json (deployed)

{
    "mcpServers": {
        "datarobot-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote@latest",
                "https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp",
                "--header",
                "Authorization: ${AUTH_HEADER}",
                "--header",
                "x-datarobot-api-token: ${DR_API_TOKEN}",
                "--transport",
                "http"
            ],
            "env": {
                "AUTH_HEADER": "Bearer <DATAROBOT_API_TOKEN>",
                "DR_API_TOKEN": "<DATAROBOT_API_TOKEN>"
            }
        }
    }
}

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

Claude Desktop MCPのデバッグ

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

VS Code（GitHub Copilotと連携）には、組み込みのMCPクライアントサポートが含まれています。 mcp.jsonファイルでリモートMCPサーバーを設定します（HTTPサーバーはtype、url、およびオプションのheadersを使用します）。

VS Code Copilot MCPのドキュメント

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

設定ファイルの位置：

ワークスペース：<project-root>/.vscode/mcp.json（ソース管理にコミットできる、共有の非シークレット設定に適しています）。
ユーザープロフィール：コーディング環境のコマンドパレット（⇧⌘P / Ctrl+Shift+P）から、MCP: Open User Configurationを実行します。 APIキーやその他の資格情報には、この場所、または別のシークレット管理メカニズムを使用してください。

APIキーをコミットしないでください

MCPの設定にAuthorizationやx-datarobot-api-tokenなどのヘッダーが含まれている場合、それらのシークレットをソース管理にコミットしないでください。資格情報の設定は、ユーザープロフィールmcp.jsonまたは別の安全なシークレットストアに保管します。

また、コーディング環境のコマンドパレットにあるMCP: Add Serverを使用すると、ガイドに従って設定を行うことができます。その他のオプションについては、VS CodeでのMCPサーバーの追加と管理を参照してください。

ポート9000でDataRobot Agentic Starterを使用するローカルMCPサーバーの場合：

.vscode/mcp.json (Agentic Starter local)

{
    "servers": {
        "datarobotMcp": {
            "type": "http",
            "url": "http://localhost:9000/mcp",
            "headers": {
                "Authorization": "Bearer <DATAROBOT_API_TOKEN>",
                "x-datarobot-api-token": "<DATAROBOT_API_TOKEN>"
            }
        }
    }
}

ポート8080でDataRobot MCPのテンプレートを使用するローカルMCPサーバーの場合：

.vscode/mcp.json (local, port 8080)

{
    "servers": {
        "datarobotMcp": {
            "type": "http",
            "url": "http://localhost:8080/mcp",
            "headers": {
                "Authorization": "Bearer <DATAROBOT_API_TOKEN>",
                "x-datarobot-api-token": "<DATAROBOT_API_TOKEN>"
            }
        }
    }
}

デプロイ済みMCPサーバーの場合：

.vscode/mcp.json (deployed)

{
    "servers": {
        "datarobotMcp": {
            "type": "http",
            "url": "https://{DATAROBOT_URL}/api/v2/deployments/{DEPLOYMENT_ID}/directAccess/mcp",
            "headers": {
                "Authorization": "Bearer <DATAROBOT_API_TOKEN>",
                "x-datarobot-api-token": "<DATAROBOT_API_TOKEN>"
            }
        }
    }
}

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

適用と確認¶

接続を確認するには：

MCPの設定を正しい場所に保存します。
MCPクライアントを再起動します（またはウィンドウを再読み込みします）。
MCPクライアントで、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のテンプレート — DataRobotと連携するスタンドアロンMCPサーバーを構築およびデプロイします。
DataRobot MCPのテンプレート — MCPクライアントの設定 — テンプレートリポジトリからのクライアント設定の詳細。
DataRobot Agentic Starterのテンプレート — MCPサーバーを含む完全なエージェントアプリケーション。
Model Context Protocol — 公式のMCP仕様。