概要
MCPサーバーは、以下を提供することでエージェントの機能を拡張します:- 外部ツールアクセス - サードパーティサービスやAPIに接続
- データソース統合 - データベース、ファイルシステム、クラウドストレージへのアクセス
- カスタム機能 - 特定のユースケースに対する専門ツールの追加
- 標準化されたインターフェース - すべての統合に対する一貫したプロトコルの使用
- 安全な認証 - OAuth 2.0とカスタムヘッダーのサポート
仕組み
1. MCPサーバー接続
エージェントにMCPサーバーを追加すると:- サーバー登録 - サーバーがエージェント設定に登録されます
- ツール検出 - エージェントがMCPサーバーから利用可能なツールを検出します
- ツール統合 - ツールが会話中にエージェントから利用可能になります
- 動的実行 - エージェントは必要に応じてこれらのツールを呼び出すことができます
2. ツール実行フロー
3. 複数サーバー
1つのエージェントに対して複数のMCPサーバーを構成できます:- 各サーバーは独自のツールセットを提供します
- ツールにはサーバー名がプレフィックスとして付加されます(例:
sentry_get_errors) - サーバーは個別に有効化または無効化できます
クイックスタート
人気のあるMCPサーバーの追加
- サイドバーのエージェントに移動します
- エージェントを選択または作成します
- 編集をクリックしてエージェントビルダーを開きます
- MCPタブに移動します
- 人気サーバーのクイック追加セクションで、サーバータイルをクリックして追加します
人気サーバー
Sentry
アプリケーションのエラーとパフォーマンス問題を監視します。- URL:
https://mcp.sentry.dev/mcp - 転送: HTTP
- 認証: OAuth 2.0
- スコープ:
org:read project:write team:write event:write
- エラーレポートの表示
- パフォーマンス指標の監視
- プロジェクトとチームの管理
- イベントと問題の追跡
ビデオチュートリアル
MCPサーバーの追加と設定方法については、このビデオをご覧ください:カスタムMCPサーバーの追加
ステップ1:MCP設定にアクセス
- サイドバーのエージェントに移動します
- エージェントを選択または作成します
- 編集をクリックしてエージェントビルダーを開きます
- MCPタブに移動します
- 高度な設定セクションまでスクロールします
ステップ2:新しいサーバーを追加
- サーバーを追加ボタンをクリックします
- サーバー設定フォームが表示されます
ステップ3:サーバー設定を構成
サーバー名
MCPサーバーに一意の名前を入力します(例:my-custom-server、weather-api、database-connector)。
ベストプラクティス:
- 小文字とハイフンを使用してください
- 記述的かつ簡潔にしてください
- 特殊文字は避けてください
転送タイプ
エージェントがMCPサーバーと通信する方法を選択します: HTTP(streamable_http)- 標準HTTPリクエスト
- REST APIやWebサービスに最適
- リクエスト/レスポンスパターンをサポート
- リアルタイムストリーミング通信
- ライブデータフィードに最適
- サーバーからクライアントへの一方通行ストリーミングをサポート
サーバーURL
MCPサーバーのエンドポイントURLを入力します: HTTP例:https://api.example.com/mcphttp://localhost:8000/mcp/https://mcp.example.com/v1
https://api.example.com/ssehttps://stream.example.com/events
ステップ4:認証を設定
認証なし
MCPサーバーに認証が不要な場合は認証なしを選択します。OAuth 2.0
OAuth保護付きサーバーの場合:- 認証方法としてOAuth 2.0を選択します
- OAuthスコープを入力します(スペース区切り)
- 例:
read write admin - 例:
org:read project:write team:write
- 例:
- ユーザーがエージェントとインタラクションすると、認証が求められます
- 認証は自動的に処理されます
- トークンは安全に保存され、必要に応じて更新されます
ステップ5:カスタムヘッダー(オプション)
MCPサーバーにカスタムHTTPヘッダーが必要な場合:- ヘッダーを追加をクリックします
- ヘッダー名を入力します(例:
X-API-Key、Authorization) - ヘッダー値を入力します
- 必要に応じて追加のヘッダーを追加します
X-API-Key:your-api-keyAuthorization:Bearer tokenX-Custom-Header:custom-value
ステップ6:サーバーの有効化/無効化
有効チェックボックスを切り替えて、サーバーがアクティブかどうかを制御します:- 有効:サーバーツールがエージェントから利用可能になります
- 無効:サーバーツールは非表示になりますが、設定は保持されます
ステップ7:接続テスト
- テストボタンをクリックして接続を検証します
- テスト結果を待ちます:
- 成功:サーバーに到達でき、正しく設定されています
- エラー:設定とネットワーク接続を確認してください
ステップ8:設定の保存
- 保存をクリックしてMCPサーバー設定を保存します
- サーバーがエージェントから利用可能になりました
MCPサーバーの管理
設定済みサーバーの表示
MCPタブで以下を確認できます:- サーバー数 - 設定済みサーバーの数
- サーバーステータス - 有効/無効のステータス
- サーバー名 - すべての設定済みサーバーの一覧
サーバー設定の編集
- 高度な設定セクションでサーバーを検索します
- サーバー設定を展開するためにクリックします
- 設定を変更します
- テストをクリックして変更を検証します
- 設定は自動的に保存されます
サーバーの削除
- 削除するサーバーを検索します
- 削除アイコン(ゴミ箱)をクリックします
- 削除を確認します
- サーバーがエージェント設定から削除されます
サーバーの有効化/無効化
任意のサーバーの有効チェックボックスを切り替えます:- 有効:サーバーツールを利用可能にします
- 無効:サーバーツールを非表示にしますが、設定は保持します
- 問題のあるサーバーの一時的な無効化
- 異なるサーバー設定のテスト
- 設定を削除せずにサーバーの可用性を管理
転送タイプ
HTTP(streamable_http)
使用する場合:- REST APIへの接続
- 標準的なリクエスト/レスポンスパターン
- Webサービスとマイクロサービス
- URLはMCPエンドポイントを指す必要があります
- 標準HTTPメソッドをサポート
- ほとんどのWebサービスで動作
SSE(Server-Sent Events)
使用する場合:- リアルタイムデータストリーム
- ライブアップデートと通知
- サーバーからクライアントへの一方通行通信
- URLはSSEエンドポイントを指す必要があります
- サーバーがSSEプロトコルをサポートしている必要があります
- 切断時に自動再接続
認証方法
認証なし
MCPサーバーに認証が不要な場合に使用します:- 公開API
- 社内サービス
- 開発/テストサーバー
- 認証なしを選択
- 追加の設定は不要
OAuth 2.0
安全な、ユーザー認証付きアクセスに使用します:- サードパーティサービス(Sentry、Canvaなど)
- ユーザー固有のデータアクセス
- スコープ付き権限
- OAuth 2.0を選択
- OAuthスコープを入力(スペース区切り)
- 初回使用時にユーザーが認証します
- Sentry:
org:read project:write team:write event:write - Canva:
asset:read asset:write design:read design:write - カスタム:
read write admin
- ユーザーがエージェントとインタラクション
- エージェントがOAuth保護付きサーバーのMCPツールを必要とする
- ユーザーに認証が求められる
- 認証が自動的に完了
- トークンが安全に保存される
- 将来のリクエストは保存されたトークンを使用
カスタムヘッダー
カスタムヘッダーは以下に使用します:- APIキー
- カスタム認証トークン
- サービス固有のヘッダー
- リクエストメタデータ
ヘッダーの追加
- サーバー設定でカスタムヘッダーセクションを見つけてください
- ヘッダーを追加をクリックします
- ヘッダー名を入力します(例:
X-API-Key) - ヘッダー値を入力します
- 必要に応じてより多くのヘッダーを追加します
一般的なヘッダーパターン
APIキー:ユースケース
エラー監視
Sentry MCPサーバー アプリケーションのエラーとパフォーマンスを監視します:- 「過去24時間のエラーを表示して」
- 「プロジェクトXのエラーレートは?」
- 「未解決の問題をすべて一覧表示して」
データベースアクセス
カスタムデータベースMCPサーバー データベースに接続します:- 「usersテーブルをクエリして」
- 「最近の注文を表示して」
- 「顧客統計を取得して」
ファイルシステムアクセス
ファイルシステムMCPサーバー ファイルとディレクトリにアクセスします:- 「ドキュメントフォルダのファイルを一覧表示して」
- 「設定ファイルを読み取って」
- 「「error」を含むファイルを検索して」
リアルタイムデータストリーム
SSE MCPサーバー ライブデータフィードに接続します:- 「リアルタイムの株価を表示して」
- 「システム指標を監視して」
- 「リアルタイムイベントを追跡して」
ベストプラクティス
サーバー命名
- 記述的にする:明確で意味のある名前を使用してください
- 小文字を使用:ハイフン付きの小文字を推奨します
- 特殊文字を避ける:文字、数字、ハイフンに限定してください
- 一貫性を保つ:命名規則に従ってください
sentry-monitoringpostgres-productionweather-api
Server1my_mcp_serverMCP-Server!!!
URL設定
- HTTPSを使用:常に安全な接続を優先してください
- 完全なパスを含む:完全なエンドポイントURLを指定してください
- URLをテスト:保存前にURLがアクセス可能であることを確認してください
- エンドポイントを文書化:エンドポイントのドキュメントを保管してください
認証
- 可能な限りOAuthを使用:APIキーよりも安全です
- スコープを最小限に:必要な権限のみをリクエストしてください
- 安全に保存:トークンは自動的に処理されます
- 認証をテスト:OAuthフローが正しく動作することを確認してください
エラー処理
- 接続をテスト:保存前にテストボタンを使用してください
- ログを監視:接続エラーを確認してください
- 障害を処理:重要なサーバーのフォールバックを構成してください
- 問題のあるサーバーを無効化:必要に応じて一時的に無効にしてください
パフォーマンス
- サーバー数を制限:サーバーが多すぎるとエージェントが遅くなる可能性があります
- 未使用サーバーを無効化:アクティブなサーバーのみを有効にします
- ヘッダーを最適化:必要なカスタムヘッダーのみを含めてください
- 応答時間を監視:遅いMCPサーバーの応答に注意してください
トラブルシューティング
接続障害
問題:テスト接続が失敗する 考えられる原因:- 不正なURL
- ネットワーク接続の問題
- サーバーが実行されていない
- ファイアウォールが接続をブロック
- URLが正しくアクセス可能であることを確認
- ネットワーク接続を確認
- サーバーが実行されていることを確認
- ファイアウォールルールを確認
認証エラー
問題:OAuth認証が失敗する 考えられる原因:- 不正なOAuthスコープ
- サーバーがOAuthをサポートしていない
- ユーザーが認証していない
- トークンが期限切れ
- OAuthスコープが正しいことを確認
- サーバーのOAuthドキュメントを確認
- 接続を再認証
- トークンの有効期限設定を確認
ツールが利用できない
問題:MCPサーバーツールが表示されない 考えられる原因:- サーバーが無効
- 接続が確立されていない
- サーバーが応答しない
- ツール検出が失敗
- サーバーを有効にする
- 接続をテスト
- サーバーが実行されていることを確認
- サーバーログを確認
タイムアウトエラー
問題:リクエストがタイムアウトする 考えられる原因:- サーバーの応答が遅い
- ネットワーク遅延
- サーバーの過負荷
- 不正なタイムアウト設定
- サーバーパフォーマンスを確認
- ネットワーク速度を確認
- サーバー負荷を軽減
- 設定可能な場合はタイムアウト設定を調整
MCPサーバーのテスト
接続テスト
- MCPサーバーを設定
- テストボタンをクリック
- 結果を待つ:
- 成功:成功メッセージ付きの緑色インジケータ
- エラー:エラー詳細付きの赤色インジケータ
テスト結果
成功インジケータ:- 接続成功メッセージ
- サーバーが正しく応答
- 認証が動作(該当する場合)
- 接続タイムアウト
- 認証失敗
- 不正なURL
- サーバーが応答しない
結果の解釈
成功:セキュリティに関する考慮事項
OAuthセキュリティ
- トークン保存:トークンは安全に保存されます
- トークン更新:期限切れ時に自動更新
- スコープ制限:最小限の必要なスコープのみをリクエスト
- ユーザー認証:ユーザーが明示的に認証する必要があります
カスタムヘッダー
- 機密データ:可能な限りヘッダーに機密データを含めないでください
- APIキー:可能な限りAPIキーの代わりにOAuthを使用してください
- ヘッダーの可視性:ヘッダーは設定に保存されます
- アクセス制御:MCP設定の表示/編集権限を制限してください
ネットワークセキュリティ
- HTTPSのみ:本番サーバーでは常にHTTPSを使用してください
- 社内ネットワーク:プライベートサーバーには社内URLを使用してください
- ファイアウォールルール:ファイアウォールを適切に構成してください
- VPNアクセス:必要な場合に安全な接続のためにVPNを使用してください
例
例1:Sentry統合
設定:- エージェントがエラーを監視可能
- パフォーマンス指標を表示
- Sentryプロジェクトを管理
例2:カスタムAPI統合
設定:- エージェントがカスタムAPIエンドポイントを呼び出し可能
- 保護されたリソースにアクセス
- 識別のためのカスタムヘッダーを使用
例3:社内サービス
設定:- エージェントが社内サービスにアクセス可能
- OAuth不要
- 社内認証のためのカスタムヘッダー
関連機能
- ツールキット - ビルドイン統合とツール
- ツール - カスタムツールとアクション
- エージェント設定 - エージェントの動作を構成
- API統合 - 外部APIに接続
ツールキット
ビルドインツールキットと統合について学ぶ