なぜ MCP を使うのか?
- Sentry、Datadog、Vercel のログを掘り下げて調査する
- データベース MCP を使って、Slack 上で Devin をデータアナリストとして使う
- SonarQube、CircleCI、Jam の問題を深掘りして調査する
- Linear のチケット、Notion ドキュメント、Google ドキュメント(Zapier 経由)などを一括で作成する
- Airtable、Stripe、Hubspot から関連情報を取得し、連携して操作する
- そのほか、さまざまなことが行えます!
MCP を使い始める
Devin をデータベース MCP に接続して Slack でのデータ分析に活用する
ステップバイステップガイドをご覧ください。
MCP のユースケースを閲覧する
Datadog、Sentry、Linear、Figma などの MCP と組み合わせた Devin の実践例をご覧ください。
設定のヒント
OAuth で認証する MCP の場合、アカウントを接続するためにアクセスする URL が Devin によって表示されます。サービスアカウントの使用を強く推奨します。組織内でアクセスが共有されるため、個人アカウントは使用しないでください。
目的の MCP が見つかりませんか?「Add Your Own」オプションを使って設定できます。問題が発生した場合は、サポートページ から、または support@cognition.ai までお問い合わせください。
カスタム MCP サーバーのセットアップ
| Transport | 最適な用途 | 必須フィールド |
|---|---|---|
| STDIO | ローカルの CLI ベースのサーバー(例:npx、uvx、Docker) | Command、args、環境変数 |
| SSE | Server-Sent Events を使用するリモートサーバー | Server URL、headers |
| HTTP | Streamable HTTP を使用するリモートサーバー | Server URL、headers |
手順: カスタム MCP サーバーの追加
- Settings > MCP Marketplace に移動します。
- ページ上部の Add Your Own をクリックします。
- サーバーの詳細を入力します:
- Server Name: サーバーのわかりやすい名前(例: 「Internal API Gateway」)。
- Icon(任意): サーバーのアイコンとして使用する絵文字または URL。
- Short Description: サーバーが何を行うかの簡潔な概要。
- transport type(STDIO、SSE、または HTTP)を選択します。
- トランスポート種別ごとの設定フィールドに入力します(下記の Configuration format を参照)。
- Save をクリックしてサーバーを作成します。
- Test listing tools をクリックして接続を検証します。Devin は分離されたテスト環境を立ち上げ、サーバーに接続して利用可能なツールの検出を試行します。
Test listing tools ボタンは、設定を保存するまで無効になっています。検証に失敗した場合は表示されるエラーメッセージを確認してください。接続、認証、タイムアウトのどこに問題があるかが示されます。
設定フォーマット
以下の例では、各トランスポートの設定フィールドを JSON で表現しています。実際には、これらはウェブフォームから入力するだけで済み、JSON を記述したり貼り付けたりする必要はありません。ここでは、分かりやすさのためと、API やプログラムからのセットアップ時の参考として JSON 形式を示しています。
STDIO トランスポート
- Command (必須): 実行するコマンド (例:
npx、uvx、docker)。 - Arguments: サーバーに渡すコマンドライン引数。
- Environment Variables: サーバーのプロセス環境に設定されるキーと値のペア。APIキー、トークン、または設定値を渡すために使用します。
npx を使ったカスタム STDIO サーバー:
SSE と HTTP のトランスポート
- Server URL(必須): MCP サーバーのエンドポイント URL。
- Authentication method:
None、Auth Header、OAuthから選択します。- Auth Header の場合: ヘッダー名(デフォルトは
Authorization)とヘッダー値(例:Bearer your-token)を指定します。 - OAuth の場合: Devin は初回セッション中に OAuth フローを完了するよう求めます。
- Auth Header の場合: ヘッダー名(デフォルトは
よくあるパターン
内部 API への接続
データベースへの接続
本番データベースでは、読み取り専用 の接続文字列、または権限を制限したデータベースユーザーを使用してください。Devin はユーザーの指示に基づいてクエリを実行するため、アクセス権限の範囲を適切に制御することが重要です。
カスタムツールやスクリプトへの接続
uvx を使った Python ベースのサーバーです:
シークレットには環境変数を使用する
カスタム MCP サーバーのトラブルシューティング
「Test listing tools」が失敗する
| 症状 | 想定される原因 | 対処方法 |
|---|---|---|
| ”Verify server URL and network connectivity” | サーバーURLに接続できない | URLが正しく、インターネット(VPN使用時はDevinのネットワーク)からアクセスできることを確認してください |
| ”Check authentication credentials and permissions” | 認証情報が無効または不足している | APIキー、トークン、またはOAuth設定を確認してください |
| ”Server took too long to respond - check server status” | サーバーがタイムアウトまでに応答しなかった | サーバーが起動していて応答していることを確認し、接続をブロックしているファイアウォールルールがないか確認してください |
| ”MCP server validation failed” (generic) | コマンドが見つからない、依存関係の不足、またはサーバーのクラッシュ | STDIOサーバーの場合、コマンドが存在してローカルで実行できることを確認し、必要な環境変数がすべて設定されていることを確認してください |
サーバーには接続できるがツールが利用できない
- サーバーが MCP プロトコルの
tools/listメソッドを正しく実装しているか確認します。 - STDIO サーバーの場合、プロセスが stdout に有効な JSON-RPC メッセージを書き出し、stdin から読み取っていることを確認します。stdout へのログやデバッグ出力はプロトコルに違反する原因になります。
- 環境変数が正しく設定されているか確認します。値が設定されていない場合(例: APIキーが空の場合)、サーバーは起動してもツールの登録に失敗することがあります。
OAuth 認証の問題
- 認証を求められたら、開いたブラウザウィンドウで OAuth フローを完了してください。Devin はコールバックを待機します。
- 認証に失敗する場合は、OAuth リダイレクト URI がプロバイダー側で正しく設定されているか確認してください。
- OAuth ベースの MCP サーバーを認証できるのは、組織の管理者のみです。権限エラーが表示される場合は、所属組織の管理者に連絡してください。
OAuth ベースの MCP を利用する場合は、個人アカウントではなくサービスアカウントを使用してください。アクセスは組織全体で共有され、すべてのメンバーのセッションで同じ認証済み接続が使用されます。
一般的なデバッグのヒント
- まずはローカルでサーバーを確認する。 カスタムサーバーを Devin に追加する前に、自分のマシンからコマンドを実行するか URL にアクセスして、正しく動作することを確認してください。
- Devin のセッションログを確認する。 セッション中にサーバーの動作が失敗した場合、Devin はエラーをログに記録します。セッション出力の中から MCP 関連のメッセージを探してください。
- シンプルに始めて段階的に拡張する。 まずは最小限の構成(例: 認証なし、デフォルト設定)から始めて、基本的な接続が動作することを確認してから、徐々に設定を複雑にしていってください。
- 環境変数を確認する。 よくある問題は、環境変数が不足している、または名前を間違えているケースです。必要な変数がすべて設定(コンフィグ)で正しく定義されていることを必ず再確認してください。
Marketplace MCPs
Vercel、Atlassian、Notion、Sentry、Neon、Asana、Jam など多数
- AlloyDB
- Asana
- Atlassian
- BigQuery
- Cloud SQL (MySQL)
- Cloud SQL (PostgreSQL)
- Cloud SQL (SQL Server)
- Cloudflare
- Cortex
- Dataplex
- Fireflies
- Firestore
- Jam
- Linear
- Looker
- Metabase
- MySQL
- Neon
- Notion
- PostgreSQL
- Prisma
- Sentry
- Spanner
- SQL Server
- Vercel
- さらに多数!
Linear: Linear integration が接続済みの場合、Devin にはすでに Linear のネイティブツールが含まれているため、Linear MCP を別途設定する必要はありません。
Datadog
- DATADOG_API_KEY - Datadog の API キー。Datadog の /organization-settings/api-keys ページで確認できます
- DATADOG_APP_KEY - Datadog のアプリケーションキー。Datadog の /organization-settings/application-keys ページで確認できます
Slack
まず api.slack.com/apps にアクセスし、自分のアプリを選択します。その後:
- サイドバーで OAuth & Permissions に移動します
- Bot User OAuth Token(「xoxb-」で始まるはずです)を探します
- Bot User OAuth Token が表示されない場合は、アプリレベルトークンを設定しているか(Settings > Basic Information)、少なくとも 1 つのスコープを追加しているか(Settings > OAuth & Permissions)、そしてアプリをワークスペースにインストールしているかを確認してください
- 次の curl コマンドを使用します:
curl -H "Authorization: Bearer xoxb-your-token" https://slack.com/api/auth.testここでxoxb-your-tokenは OAuth トークンに置き換えてください
- 次の curl コマンドを使用します:
curl -H "Authorization: Bearer xoxb-your-token" https://slack.com/api/conversations.listここでxoxb-your-tokenは OAuth トークンに置き換えてください - このコマンドを動作させるには、少なくとも次のスコープを追加する必要があります: channels:read,groups:read,mpim:read,im:read
Supabase
Figma
- Figma のホーム画面で、左上のプロフィールアイコンをクリックし、ドロップダウンから「Settings」を選択します。
- 設定メニューで「Security」タブを選択します。
- 「Personal access tokens」セクションまでスクロールし、「Generate new token」をクリックします。
- トークン名を入力し、適切な権限が付与されていることを確認します。少なくとも「File content」および「Dev resources」への読み取り権限を付与することを推奨します。
- 「Generate token」をクリックします。
Stripe
Bearer <TOKEN> という形式の Authorization ヘッダーを指定する必要があります。<TOKEN> には Stripe API キーを設定してください。詳細: https://docs.stripe.com/mcp#bearer-token
ドキュメント
Zapier
Bearer <TOKEN> という形式の authorization ヘッダーを指定する必要があります。
https://mcp.zapier.com/mcp/servers > Connect で表示される Server URL から、Bearer トークンを取得する必要があります。
Server URL は次のような形式になります: https://mcp.zapier.com/api/mcp/s/*****/mcp
アスタリスクの部分 (*****) を取り出し、指定する authorization ヘッダーで使用します: Bearer *****

Airtable
Docker Hub
- Docker Hub ユーザー名: My Hub から取得できます
- パーソナルアクセス トークン: Account settings > Personal access tokens に移動し、トークンを作成します

SonarQube
- SonarQube トークン: My Account > Security に移動し、API トークンを生成します
- SonarQube org: あなたのユーザー名です。下の画像に例が示されています

- SonarQube URL:
- セルフホストの場合: 形式は http://localhost:9000 または https://sonarqube.mycompany.com
- SonarCloud の場合: https://sonarcloud.io を使用します
Netlify

Pulumi

Parallel
Heroku

CircleCI
CIRCLECI_TOKEN- CircleCI API トークン。https://app.circleci.com/settings/user/tokens で作成できます。API トークンは作成直後に必ずコピーしてください。一度画面を離れると再表示できません。

CIRCLECI_BASE_URL[オプション] - オンプレミス環境のお客様のみ設定が必要なオプションです。デフォルト値は"https://circleci.com"です。
Cortex
- Cortex インスタンスにログインします。
- 左側のメニューから Settings → My access tokens に移動します。
- Create new token をクリックします。
- トークン名と説明を入力します。
- Create token をクリックし、表示されたトークンをコピーします。
https://api.getcortexapp.com)で設定されていることを確認してください。
Documentation
Square
Bearer <TOKEN> という形式の認可ヘッダーを指定する必要があります。ここでの <TOKEN> は Square のアクセス トークンです。詳細については https://developer.squareup.com/docs/build-basics/access-tokens を参照してください。
Documentation
Hubspot
- HubSpot でプライベートアプリを作成します
- 「Settings」>「Integrations」>「Private Apps」へ移動します
- 「Create private app」をクリックします
- アプリ名を入力し、必要なスコープを設定します
- 「Create app」をクリックします
- 「Auth」タブから生成されたアクセストークンをコピーします
Redis
- Redis ホスト
- Redis ポート
- Redis ユーザー名
- Redis パスワード
Google マップ



Playwright
Firecrawl
FIRECRAWL_API_KEY)を用意する必要があります。https://www.firecrawl.dev/app/api-keys で確認および作成できます。
ドキュメント
ElasticSearch
ES_URL- ElasticSearch の URL またはエンドポイント。Elasticsearch の /overview ページで確認できます。ES_API_KEY- ElasticSearch の API キー。Elasticsearch の/indices/index_details/<name>/dataページで作成できます。

ES_SSL_SKIP_VERIFY はオプションの環境変数です。true に設定すると、Elasticsearch への接続時に SSL/TLS 証明書の検証をスキップします。
Documentation
Postgres
Plaid
Replicate
Grafana
- Grafana URL
- Grafana service account token: トークンを取得するには、サイドバーで
Administration > Users and access > Service accounts > Add service account(まだ作成していない場合)>Add service account tokenに移動します

Pinecone

Snyk
- まず、MCP サーバーを設定します。ドキュメントはこちらにあります。注意: 最後に環境変数を 1 つ追加してください(ドキュメントには記載されていません)。

- Devin のマシンに Snyk CLI をインストールします。ドキュメントはこちらにあります。

