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

> エージェントコーディング環境をMCPサーバーに接続する - Cursor、Claude Desktop、VS
> Codeを設定して、エージェントコーディングワークフローのツールやリソースにDataRobot MCPサーバーを使用します。

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-15T05:55:44.570057+00:00` (UTC).

## Primary page

- [エージェントコーディング環境をMCPサーバーに接続する](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [DataRobot Global MCPの使用](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#using-the-datarobot-global-mcp): In-page section heading.
- [設定](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#configuration): In-page section heading.
- [スタンドアロンMCPサーバーの使用](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#using-a-standalone-mcp-server): In-page section heading.
- [前提条件](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#prerequisites): In-page section heading.
- [エンドポイントリファレンス](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#endpoint-reference): In-page section heading.
- [環境設定](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#configure-your-environment): In-page section heading.
- [適用と確認](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#apply-and-verify): In-page section heading.
- [トラブルシューティング](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#troubleshooting): In-page section heading.
- [クライアントがMCPサーバーに接続できない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#client-cannot-connect-to-mcp-server): In-page section heading.
- [クライアントにツールが表示されない](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#tools-do-not-appear-in-the-client): In-page section heading.
- [認証エラー](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#authentication-errors): In-page section heading.
- [その他のリソース](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-mcp-clients.html.md#additional-resources): In-page section heading.

## Documentation content

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サーバー。

> [!NOTE] MCPサーバーとエージェントアプリケーションの比較
> このページでは、 MCPクライアント（Cursor、Claude Desktop、VS Code）をMCPサーバーに接続 する方法について説明します。 MCPサーバーを DataRobotのエージェントワークフロー （例：Agentic StarterテンプレートのLangGraphエージェント）に統合する方法については、 [MCPサーバーを使用したツールの統合](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-mcp/agentic-tools-mcp.html.md) を参照してください。

## DataRobot Global MCPの使用

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

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

### 設定

DataRobot Global MCPでは、リクエストの認証にAPIキーが必要です。 DataRobotのUIでユーザーメニューを開き、 APIのキーとツール を選択すると、APIキーを取得できます。 詳細については、 [APIキー管理](https://docs.datarobot.com/ja/docs/platform/acct-settings/api-key-mgmt.html.md) を参照してください。

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

**Cursor:**
```
{
  "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:**
```
{
    "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サーバーのツールを使用するように依頼します。

**VS Code:**
```
{
  "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サーバー（ローカルまたはデプロイ済み）：
- ローカル
- デプロイ完了
- エンドポイントと認証
- "Authorization": "Bearer <DATAROBOT_API_TOKEN> "（MCPサーバーでの認証に必要）
- "x-datarobot-api-token": " <DATAROBOT_API_TOKEN> "（ツールの実行に必要）

> [!TIP] デプロイ済み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クライアントに対応する手順を参照してください。

**Cursor:**
> [!NOTE] Cursor MCPのドキュメント
> Cursorの現在のMCPオプションについては、 [CursorのMCPドキュメント](https://cursor.com/docs/context/mcp) を参照してください。

設定ファイルの位置 ：

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

ポート9000で [DataRobot Agentic Starter](https://github.com/datarobot-community/datarobot-agent-application) を使用するローカルMCPサーバーの場合：

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

ポート8080で [DataRobot MCPのテンプレート](https://github.com/datarobot-community/af-component-datarobot-mcp) を使用するローカルMCPサーバーの場合：

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

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

```
{
    "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:**
Claude DesktopはHTTP経由でリモートMCPサーバーに接続できます。 `claude_desktop_config.json` でMCPサーバーを設定します。

> [!NOTE] Claude Desktop MCPのドキュメント
> Claude Desktopの現在のMCPオプションについては、 [Claude DesktopのMCPドキュメント](https://docs.anthropic.com/en/docs/build-with-claude/mcp) を参照してください。

設定ファイルの位置 ：

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

ポート9000で [DataRobot Agentic Starter](https://github.com/datarobot-community/datarobot-agent-application) を使用するローカルMCPサーバーの場合：

```
{
    "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のテンプレート](https://github.com/datarobot-community/af-component-datarobot-mcp) を使用するローカルMCPサーバーの場合：

```
{
    "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サーバーの場合：

```
{
    "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のドキュメント](https://docs.anthropic.com/en/docs/build-with-claude/mcp) とサーバーのドキュメントを確認してください）。

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

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

> [!NOTE] VS Code Copilot MCPのドキュメント
> VS Codeの現在のMCPオプション、設定スキーマ、セキュリティに関する注意事項については、 [VS CodeでのMCPサーバーの使用](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) および [MCP設定リファレンス](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration) を参照してください。

設定ファイルの位置 ：

ワークスペース：
<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サーバーの追加と管理](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) を参照してください。

ポート9000で [DataRobot Agentic Starter](https://github.com/datarobot-community/datarobot-agent-application) を使用するローカルMCPサーバーの場合：

```
{
    "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のテンプレート](https://github.com/datarobot-community/af-component-datarobot-mcp) を使用するローカルMCPサーバーの場合：

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

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

```
{
    "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サーバーの使用](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) とサーバーのドキュメントを参照してください。


## 適用と確認

接続を確認するには：

1. MCPの設定を正しい場所に保存します。
2. MCPクライアントを再起動します（またはウィンドウを再読み込みします）。
3. MCPクライアントで、AIにDataRobot MCPサーバーのツールを一覧表示または使用するように依頼します。

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

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

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

解決方法 ：

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

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

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

解決方法 ：

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

### 認証エラー

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

解決方法 ：

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

## その他のリソース

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