メインコンテンツへスキップ

接続

MCP サーバーは標準の MCP プロトコルを使用します。以下のサポートされているいずれかの方法で接続してください。お使いのクライアントがサポートしている方法を使用します。クライアントの例では、一般的な AI ツールがどのように接続するかを示しています。

必要な権限

  • ご利用の DoiT プランには DoiT API へのアクセスが含まれている必要があります。このアクセスがない場合、認可に失敗したり、リクエストが認可エラーを返す可能性があります。ご利用のプランに DoiT API へのアクセスが含まれているか不明な場合は、DoiT のアカウントマネージャーにお問い合わせいただくか、Cloud Intelligence プランを確認してください。

  • 認証方法は接続方法によって異なります。Remote Streamable HTTP では、サインイン済みの DoiT アカウントを使用します。Local stdio では、DOIT_API_KEY として指定する personal API token を使用します。

  • MCP サーバーツールは Cloud Intelligence API にマッピングされています。各 API operation はそれぞれ固有の権限を必要とします。使用するツールに必要な権限を、API トークンのスコープ(またはユーザーの権限)に含めてください。

前提条件

  • リモート(Streamable HTTP)接続の場合、接続時に DoiT のサインインフローを完了できるサポート対象の Web ブラウザが必要です。

  • ローカル(stdio)接続の場合、npx@doitintl/doit-mcp-server を実行できるよう、マシンに Node.js がインストールされている必要があり、DOIT_API_KEY として使用する personal API token が必要です。ローカル stdio はブラウザのサインインフローを使用しません。

接続方法

リモート(Streamable HTTP)

クライアントは HTTPS 経由で次のエンドポイントに接続します。

https://mcp.doit.com/mcp
  • 認証: 接続時にブラウザで DoiT のサインインページが開きます。DoiT アカウントでサインインし、DoiT の同意画面で Allow access を選択してください。

  • 設定: MCP クライアントで、リモート / HTTP サーバーのエントリを追加し、サーバー URL を https://mcp.doit.com/mcp に設定します。フィールド名はクライアントによって異なります(例:urlhttpUrl、または Remote MCP server URL など)。

ローカル(stdio)

クライアントは標準入力/標準出力(stdio)を使用して、マシン上で公開パッケージを起動します。

npx -y @doitintl/doit-mcp-server@latest
  • 認証: ローカル stdio は personal API token を使用して認証します。クライアント設定の env ブロック(またはクライアントがサーバーを起動する前のシェル環境)で DOIT_API_KEY を設定してください。ブラウザの OAuth サインインフローは使用しません。

  • 設定: 一般的には、commandnpxargs["-y", "@doitintl/doit-mcp-server@latest"]DOIT_API_KEY 用の env エントリを mcp.jsonconfig.toml、または同等のファイルに設定します。具体的なキー名はクライアントによって異なります。

レガシー SSE(非推奨)

https://mcp.doit.com/sse エンドポイントは、既に接続済みのクライアントが動作し続けられるようにのみ提供されています。これは非推奨であり、全てのツールセットを提供せず、新規セットアップでは使用しないでください。代わりに Streamable HTTP または stdio を使用してください。

クライアントの例

ローカルクライアントおよびデスクトップクライアントは、一般的に stdio と Streamable HTTP の両方をサポートします。ブラウザベースのクライアントは通常 Streamable HTTP のみをサポートします。

クライアントstdioStreamable HTTP
ChatGPT(web)NoYes
Claude(Desktop ・ Code ・ web connectors)YesYes
CursorYesYes
VS Code(Copilot MCP)YesYes
Codex(CLI ・ IDE)YesYes
Gemini CLIYesYes

各ページでは、少なくとも 1 つの具体的な例を順を追って説明しています。方法の詳細については、接続方法 を参照してください。

接続には AI ツールを活用

必要に応じて、利用中の AI ツールに依頼して、お使いの環境で MCP サーバーへの接続を支援させることもできます。

プロンプト例: Connect me to the MCP server at https://mcp.doit.com/mcp (Streamable HTTP) or via npx -y @doitintl/doit-mcp-server@latest with DOIT_API_KEY (stdio). I'm using <tool name>, <OS>, and <shell>. Walk me through configuration and authorization. If any command fails, help me troubleshoot and continue.