接続
MCP サーバーは標準的な MCP プロトコルを使用します。以下のサポートされているいずれかの方法で接続してください。お使いのクライアントがサポートする方法を使用します。クライアントの例では、一般的な AI ツールがどのように 接続するかを示しています。
必要な権限
-
ご利用の DoiT プランに DoiT API へのアクセスが含まれている必要があります。このアクセスがない場合、認可に失敗したり、リクエストが認可エラーを返したりすることがあります。プランに DoiT API へのアクセスが含まれているか不明な場合は、DoiT のアカウントマネージャーに問い合わせるか、ご利用の Cloud Intelligence プランを確認してください。
-
認証方法は接続方法によって異なります。Remote Streamable HTTP は、サインイン済みの DoiT アカウント、または ヘッドレスクライアント向けの 個人用 API トークンを使用します。Local stdio は、
DOIT_API_KEYとして指定された個人用 API トークンを使用します。 -
MCP サーバーツールは Cloud Intelligence API にマッピングされています。各 API operation はそれぞれ固有の権限を要求します。使用するツールに必要な権限が付与されるように、API トークンのスコープを設定するか、ユーザーに必要な権限があることを確認してください。
前提条件
-
リモート接続（Streamable HTTP）の場合、接続時に DoiT のサインインフローを完了するためのサポート対象 Web ブラウザ、またはクライアントがブラウザを開けない場合は 個人用 API トークン
-
ローカル接続（stdio）の場合、マシン上に Node.js がインストールされていて、
npxが@doitintl/doit-mcp-serverを実行できること、さらにDOIT_API_KEYとして利用可能な 個人用 API トークンが必要です。ローカル stdio ではブラウザのサインインフローは使用しません。
接続方法
リモート (Streamable HTTP)
クライアントは HTTPS 経由で次のエンドポイントに接続します:
https://mcp.doit.com/mcp
-
認証: 接続時にブラウザで DoiT のサインインページが開きます。DoiT アカウントでサインインし、DoiT の同意画面で アクセスを許可 を選択します。ブラウザを開けないクライアントは、代わりに個人用 API トークンを送信できます。ヘッドレスクライアントを参照してください。
-
設定: MCP クライアントでリモート / HTTP サーバーのエントリを追加し、サーバー URL を
https://mcp.doit.com/mcpに設定します。フィールド名はクライアントごとに異なります（例:url、httpUrl、または Remote MCP server URL など）。
ヘッドレスクライアント (API トークン)
Kubernetes クラスタ上の HolmesGPT、CI ジョブ、スケジュール実行のワーカーなど、ブラウザなしで動作するエージェントは、同じ https://mcp.doit.com/mcp エンドポイントに接続し、Bearer ヘッダーとして送信される 個人用 API トークンで認証します。
Authorization: Bearer <your personal API token>
ツールは local stdio と同様に、そのトークンの権限で実行されます。エージェント専用のトークンを作成し、それをシークレットマネージャーに保存し、定期的にローテーションしてください。DoiT スタッフアカウントの個人用 API トークンはリモートエンドポイントでは受け付けられません。
DOIT_API_KEY 環境変数を通じてトークンを渡す HolmesGPT 設定の例:
mcp_servers:
doit:
description: "DoiT Cloud Intelligence"
config:
url: "https://mcp.doit.com/mcp"
mode: streamable-http
headers:
Authorization: "Bearer {{ env.DOIT_API_KEY }}"
health_check_tool: "validate_user"
ローカル (stdio)
クライアントは標準入出力 (stdio) を使って、マシン上で公開パッケージを起動します:
npx -y @doitintl/doit-mcp-server@latest
-
認証: ローカル stdio は 個人用 API トークンで認証します。クライアント設定の
envブロック（またはクライアントがサーバーを起動する前のシェル環境）でDOIT_API_KEYを設定してください。ブラウザの OAuth サインインフローは使用しません。 -
設定: 一般的には、
commandにnpx、argsに["-y", "@doitintl/doit-mcp-server@latest"]、envのエントリとしてDOIT_API_KEYをmcp.json、config.tomlなどのファイルに設定します。具体的なキー名はクライアントによって異なります。
レガシー SSE (非推奨)
https://mcp.doit.com/sse エンドポイントは、すでに接続済みのクライアントが動作し続けられるようにのみ提供されています。これは非推奨であり、全てのツールセットを公開せず、新規セットアップでは使用しないでください。Streamable HTTP または stdio を使用してください。
クライアントの例
ローカルおよびデスクトップクライアントは、一般的に stdio と Streamable HTTP の両方をサポートします。ブラウザベースのクライアントは、通常 Streamable HTTP のみをサポートします。
| クライアント | stdio | Streamable HTTP |
|---|---|---|
| ChatGPT (web) | No | Yes |
| Claude (Desktop / Code / web connectors) | Yes | Yes |
| Cursor | Yes | Yes |
| VS Code (Copilot MCP) | Yes | Yes |
| Codex (CLI / IDE) | Yes | Yes |
| Gemini CLI | Yes | Yes |
| HolmesGPT およびその他のヘッ ドレスエージェント | No | Yes, with an API token |
各ページでは、少なくとも 1 つの具体的な例をステップごとに説明しています。各方法の詳細については、接続方法を参照してください。
必要に応じて、利用中の AI ツールに、環境内で MCP サーバーへの接続を手伝うよう依頼できます。
プロンプトの例: https://mcp.doit.com/mcp (Streamable HTTP) または npx -y @doitintl/doit-mcp-server@latest と DOIT_API_KEY (stdio) を使って MCP サーバーに接続してください。私は <tool name>、<OS>、<shell> を使用しています。設定と認可の手順を案内してください。どれかのコマンドが失敗した場合は、トラブルシュートを手伝い、そのまま続けてください。