メインコンテンツへスキップ
Model Context Protocol(MCP)は、データソースとAI搭載ツール間に安全な双方向接続を構築できるオープンスタンダードです。MCPを、AIエージェントがデータベース、ファイルシステム、Webサービス、APIなどのあらゆる外部システムとシームレスに通信できるようにする汎用翻訳者として考えてください。

概要

MCPサーバーは、以下を提供することでエージェントの機能を拡張します:
  • 外部ツールアクセス - サードパーティサービスやAPIに接続
  • データソース統合 - データベース、ファイルシステム、クラウドストレージへのアクセス
  • カスタム機能 - 特定のユースケースに対する専門ツールの追加
  • 標準化されたインターフェース - すべての統合に対する一貫したプロトコルの使用
  • 安全な認証 - OAuth 2.0とカスタムヘッダーのサポート

仕組み

1. MCPサーバー接続

エージェントにMCPサーバーを追加すると:
  1. サーバー登録 - サーバーがエージェント設定に登録されます
  2. ツール検出 - エージェントがMCPサーバーから利用可能なツールを検出します
  3. ツール統合 - ツールが会話中にエージェントから利用可能になります
  4. 動的実行 - エージェントは必要に応じてこれらのツールを呼び出すことができます

2. ツール実行フロー

User Query → Agent → MCP Tool Call → MCP Server → External System → Response → Agent → User

3. 複数サーバー

1つのエージェントに対して複数のMCPサーバーを構成できます:
  • 各サーバーは独自のツールセットを提供します
  • ツールにはサーバー名がプレフィックスとして付加されます(例:sentry_get_errors
  • サーバーは個別に有効化または無効化できます

クイックスタート

人気のあるMCPサーバーの追加

  1. サイドバーのエージェントに移動します
  2. エージェントを選択または作成します
  3. 編集をクリックしてエージェントビルダーを開きます
  4. MCPタブに移動します
  5. 人気サーバーのクイック追加セクションで、サーバータイルをクリックして追加します

人気サーバー

Sentry

アプリケーションのエラーとパフォーマンス問題を監視します。
  • URL: https://mcp.sentry.dev/mcp
  • 転送: HTTP
  • 認証: OAuth 2.0
  • スコープ: org:read project:write team:write event:write
機能:
  • エラーレポートの表示
  • パフォーマンス指標の監視
  • プロジェクトとチームの管理
  • イベントと問題の追跡

ビデオチュートリアル

MCPサーバーの追加と設定方法については、このビデオをご覧ください:

カスタムMCPサーバーの追加

ステップ1:MCP設定にアクセス

  1. サイドバーのエージェントに移動します
  2. エージェントを選択または作成します
  3. 編集をクリックしてエージェントビルダーを開きます
  4. MCPタブに移動します
  5. 高度な設定セクションまでスクロールします

ステップ2:新しいサーバーを追加

  1. サーバーを追加ボタンをクリックします
  2. サーバー設定フォームが表示されます

ステップ3:サーバー設定を構成

サーバー名

MCPサーバーに一意の名前を入力します(例:my-custom-serverweather-apidatabase-connector)。 ベストプラクティス:
  • 小文字とハイフンを使用してください
  • 記述的かつ簡潔にしてください
  • 特殊文字は避けてください

転送タイプ

エージェントがMCPサーバーと通信する方法を選択します: HTTP(streamable_http)
  • 標準HTTPリクエスト
  • REST APIやWebサービスに最適
  • リクエスト/レスポンスパターンをサポート
SSE(Server-Sent Events)
  • リアルタイムストリーミング通信
  • ライブデータフィードに最適
  • サーバーからクライアントへの一方通行ストリーミングをサポート

サーバーURL

MCPサーバーのエンドポイントURLを入力します: HTTP例:
  • https://api.example.com/mcp
  • http://localhost:8000/mcp/
  • https://mcp.example.com/v1
SSE例:
  • https://api.example.com/sse
  • https://stream.example.com/events

ステップ4:認証を設定

認証なし

MCPサーバーに認証が不要な場合は認証なしを選択します。

OAuth 2.0

OAuth保護付きサーバーの場合:
  1. 認証方法としてOAuth 2.0を選択します
  2. OAuthスコープを入力します(スペース区切り)
    • 例:read write admin
    • 例:org:read project:write team:write
OAuthフロー:
  • ユーザーがエージェントとインタラクションすると、認証が求められます
  • 認証は自動的に処理されます
  • トークンは安全に保存され、必要に応じて更新されます

ステップ5:カスタムヘッダー(オプション)

MCPサーバーにカスタムHTTPヘッダーが必要な場合:
  1. ヘッダーを追加をクリックします
  2. ヘッダー名を入力します(例:X-API-KeyAuthorization
  3. ヘッダー値を入力します
  4. 必要に応じて追加のヘッダーを追加します
一般的なヘッダー:
  • X-API-Key: your-api-key
  • Authorization: Bearer token
  • X-Custom-Header: custom-value

ステップ6:サーバーの有効化/無効化

有効チェックボックスを切り替えて、サーバーがアクティブかどうかを制御します:
  • 有効:サーバーツールがエージェントから利用可能になります
  • 無効:サーバーツールは非表示になりますが、設定は保持されます

ステップ7:接続テスト

  1. テストボタンをクリックして接続を検証します
  2. テスト結果を待ちます:
    • 成功:サーバーに到達でき、正しく設定されています
    • エラー:設定とネットワーク接続を確認してください

ステップ8:設定の保存

  1. 保存をクリックしてMCPサーバー設定を保存します
  2. サーバーがエージェントから利用可能になりました

MCPサーバーの管理

設定済みサーバーの表示

MCPタブで以下を確認できます:
  • サーバー数 - 設定済みサーバーの数
  • サーバーステータス - 有効/無効のステータス
  • サーバー名 - すべての設定済みサーバーの一覧

サーバー設定の編集

  1. 高度な設定セクションでサーバーを検索します
  2. サーバー設定を展開するためにクリックします
  3. 設定を変更します
  4. テストをクリックして変更を検証します
  5. 設定は自動的に保存されます

サーバーの削除

  1. 削除するサーバーを検索します
  2. 削除アイコン(ゴミ箱)をクリックします
  3. 削除を確認します
  4. サーバーがエージェント設定から削除されます
MCPサーバーを削除すると、そのツールがエージェントから利用できなくなります。 アクティブな会話がこれらのツールに依存していないことを確認してください。

サーバーの有効化/無効化

任意のサーバーの有効チェックボックスを切り替えます:
  • 有効:サーバーツールを利用可能にします
  • 無効:サーバーツールを非表示にしますが、設定は保持します
これは以下に役立ちます:
  • 問題のあるサーバーの一時的な無効化
  • 異なるサーバー設定のテスト
  • 設定を削除せずにサーバーの可用性を管理

転送タイプ

HTTP(streamable_http)

使用する場合:
  • REST APIへの接続
  • 標準的なリクエスト/レスポンスパターン
  • Webサービスとマイクロサービス
設定:
  • URLはMCPエンドポイントを指す必要があります
  • 標準HTTPメソッドをサポート
  • ほとんどのWebサービスで動作
例:
URL: https://api.example.com/mcp
Transport: HTTP

SSE(Server-Sent Events)

使用する場合:
  • リアルタイムデータストリーム
  • ライブアップデートと通知
  • サーバーからクライアントへの一方通行通信
設定:
  • URLはSSEエンドポイントを指す必要があります
  • サーバーがSSEプロトコルをサポートしている必要があります
  • 切断時に自動再接続
例:
URL: https://stream.example.com/sse
Transport: SSE

認証方法

認証なし

MCPサーバーに認証が不要な場合に使用します:
  • 公開API
  • 社内サービス
  • 開発/テストサーバー
設定:
  • 認証なしを選択
  • 追加の設定は不要

OAuth 2.0

安全な、ユーザー認証付きアクセスに使用します:
  • サードパーティサービス(Sentry、Canvaなど)
  • ユーザー固有のデータアクセス
  • スコープ付き権限
設定:
  1. OAuth 2.0を選択
  2. OAuthスコープを入力(スペース区切り)
  3. 初回使用時にユーザーが認証します
OAuthスコープ例:
  • Sentry: org:read project:write team:write event:write
  • Canva: asset:read asset:write design:read design:write
  • カスタム: read write admin
OAuthフロー:
  1. ユーザーがエージェントとインタラクション
  2. エージェントがOAuth保護付きサーバーのMCPツールを必要とする
  3. ユーザーに認証が求められる
  4. 認証が自動的に完了
  5. トークンが安全に保存される
  6. 将来のリクエストは保存されたトークンを使用

カスタムヘッダー

カスタムヘッダーは以下に使用します:
  • APIキー
  • カスタム認証トークン
  • サービス固有のヘッダー
  • リクエストメタデータ

ヘッダーの追加

  1. サーバー設定でカスタムヘッダーセクションを見つけてください
  2. ヘッダーを追加をクリックします
  3. ヘッダー名を入力します(例:X-API-Key
  4. ヘッダー値を入力します
  5. 必要に応じてより多くのヘッダーを追加します

一般的なヘッダーパターン

APIキー:
Header: X-API-Key
Value: your-api-key-here
ベアラートークン:
Header: Authorization
Value: Bearer your-token-here
カスタムサービスヘッダー:
Header: X-Service-Name
Value: your-service-identifier

ユースケース

エラー監視

Sentry MCPサーバー アプリケーションのエラーとパフォーマンスを監視します:
{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write"
}
エージェント機能:
  • 「過去24時間のエラーを表示して」
  • 「プロジェクトXのエラーレートは?」
  • 「未解決の問題をすべて一覧表示して」

データベースアクセス

カスタムデータベースMCPサーバー データベースに接続します:
{
  "server_name": "postgres-db",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/database",
  "auth_type": "oauth",
  "headers": {
    "X-Database-Name": "production"
  }
}
エージェント機能:
  • 「usersテーブルをクエリして」
  • 「最近の注文を表示して」
  • 「顧客統計を取得して」

ファイルシステムアクセス

ファイルシステムMCPサーバー ファイルとディレクトリにアクセスします:
{
  "server_name": "filesystem",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/files",
  "auth_type": "oauth"
}
エージェント機能:
  • 「ドキュメントフォルダのファイルを一覧表示して」
  • 「設定ファイルを読み取って」
  • 「「error」を含むファイルを検索して」

リアルタイムデータストリーム

SSE MCPサーバー ライブデータフィードに接続します:
{
  "server_name": "live-data",
  "transport": "sse",
  "url": "https://stream.example.com/sse",
  "auth_type": "oauth"
}
エージェント機能:
  • 「リアルタイムの株価を表示して」
  • 「システム指標を監視して」
  • 「リアルタイムイベントを追跡して」

ベストプラクティス

サーバー命名

  • 記述的にする:明確で意味のある名前を使用してください
  • 小文字を使用:ハイフン付きの小文字を推奨します
  • 特殊文字を避ける:文字、数字、ハイフンに限定してください
  • 一貫性を保つ:命名規則に従ってください
良い例:
  • sentry-monitoring
  • postgres-production
  • weather-api
悪い例:
  • Server1
  • my_mcp_server
  • MCP-Server!!!

URL設定

  • HTTPSを使用:常に安全な接続を優先してください
  • 完全なパスを含む:完全なエンドポイントURLを指定してください
  • URLをテスト:保存前にURLがアクセス可能であることを確認してください
  • エンドポイントを文書化:エンドポイントのドキュメントを保管してください

認証

  • 可能な限りOAuthを使用:APIキーよりも安全です
  • スコープを最小限に:必要な権限のみをリクエストしてください
  • 安全に保存:トークンは自動的に処理されます
  • 認証をテスト:OAuthフローが正しく動作することを確認してください

エラー処理

  • 接続をテスト:保存前にテストボタンを使用してください
  • ログを監視:接続エラーを確認してください
  • 障害を処理:重要なサーバーのフォールバックを構成してください
  • 問題のあるサーバーを無効化:必要に応じて一時的に無効にしてください

パフォーマンス

  • サーバー数を制限:サーバーが多すぎるとエージェントが遅くなる可能性があります
  • 未使用サーバーを無効化:アクティブなサーバーのみを有効にします
  • ヘッダーを最適化:必要なカスタムヘッダーのみを含めてください
  • 応答時間を監視:遅いMCPサーバーの応答に注意してください

トラブルシューティング

接続障害

問題:テスト接続が失敗する 考えられる原因:
  • 不正なURL
  • ネットワーク接続の問題
  • サーバーが実行されていない
  • ファイアウォールが接続をブロック
解決策:
  • URLが正しくアクセス可能であることを確認
  • ネットワーク接続を確認
  • サーバーが実行されていることを確認
  • ファイアウォールルールを確認

認証エラー

問題:OAuth認証が失敗する 考えられる原因:
  • 不正なOAuthスコープ
  • サーバーがOAuthをサポートしていない
  • ユーザーが認証していない
  • トークンが期限切れ
解決策:
  • OAuthスコープが正しいことを確認
  • サーバーのOAuthドキュメントを確認
  • 接続を再認証
  • トークンの有効期限設定を確認

ツールが利用できない

問題:MCPサーバーツールが表示されない 考えられる原因:
  • サーバーが無効
  • 接続が確立されていない
  • サーバーが応答しない
  • ツール検出が失敗
解決策:
  • サーバーを有効にする
  • 接続をテスト
  • サーバーが実行されていることを確認
  • サーバーログを確認

タイムアウトエラー

問題:リクエストがタイムアウトする 考えられる原因:
  • サーバーの応答が遅い
  • ネットワーク遅延
  • サーバーの過負荷
  • 不正なタイムアウト設定
解決策:
  • サーバーパフォーマンスを確認
  • ネットワーク速度を確認
  • サーバー負荷を軽減
  • 設定可能な場合はタイムアウト設定を調整

MCPサーバーのテスト

接続テスト

  1. MCPサーバーを設定
  2. テストボタンをクリック
  3. 結果を待つ:
    • 成功:成功メッセージ付きの緑色インジケータ
    • エラー:エラー詳細付きの赤色インジケータ

テスト結果

成功インジケータ:
  • 接続成功メッセージ
  • サーバーが正しく応答
  • 認証が動作(該当する場合)
エラーインジケータ:
  • 接続タイムアウト
  • 認証失敗
  • 不正なURL
  • サーバーが応答しない

結果の解釈

成功:
✓ Connection successful
MCP server connection tested successfully
エラー:
✗ Connection failed
Failed to connect to server: Connection timeout

セキュリティに関する考慮事項

OAuthセキュリティ

  • トークン保存:トークンは安全に保存されます
  • トークン更新:期限切れ時に自動更新
  • スコープ制限:最小限の必要なスコープのみをリクエスト
  • ユーザー認証:ユーザーが明示的に認証する必要があります

カスタムヘッダー

  • 機密データ:可能な限りヘッダーに機密データを含めないでください
  • APIキー:可能な限りAPIキーの代わりにOAuthを使用してください
  • ヘッダーの可視性:ヘッダーは設定に保存されます
  • アクセス制御:MCP設定の表示/編集権限を制限してください

ネットワークセキュリティ

  • HTTPSのみ:本番サーバーでは常にHTTPSを使用してください
  • 社内ネットワーク:プライベートサーバーには社内URLを使用してください
  • ファイアウォールルール:ファイアウォールを適切に構成してください
  • VPNアクセス:必要な場合に安全な接続のためにVPNを使用してください

例1:Sentry統合

設定:
{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write",
  "enabled": true
}
使用法:
  • エージェントがエラーを監視可能
  • パフォーマンス指標を表示
  • Sentryプロジェクトを管理

例2:カスタムAPI統合

設定:
{
  "server_name": "custom-api",
  "transport": "streamable_http",
  "url": "https://api.example.com/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "read write",
  "headers": {
    "X-Client-ID": "your-client-id"
  },
  "enabled": true
}
使用法:
  • エージェントがカスタムAPIエンドポイントを呼び出し可能
  • 保護されたリソースにアクセス
  • 識別のためのカスタムヘッダーを使用

例3:社内サービス

設定:
{
  "server_name": "internal-service",
  "transport": "streamable_http",
  "url": "http://internal-service:8000/mcp",
  "auth_type": "none",
  "headers": {
    "X-Internal-Key": "internal-key-value"
  },
  "enabled": true
}
使用法:
  • エージェントが社内サービスにアクセス可能
  • OAuth不要
  • 社内認証のためのカスタムヘッダー

関連機能

  • ツールキット - ビルドイン統合とツール
  • ツール - カスタムツールとアクション
  • エージェント設定 - エージェントの動作を構成
  • API統合 - 外部APIに接続

ツールキット

ビルドインツールキットと統合について学ぶ

サポート

MCPサーバーについてサポートが必要ですか?support@automationanywhere.comにご連絡ください。