ProxyAI MCPコネクター

できること

ProxyAI MCPコネクターを使うと、アシスタントがボット、ヘルプデスクのチケット、エージェントタスクにアクセスできるようになります。バージョン1.0.0には、8つの読み取りツールと、変更を行う11のツールが含まれます。

未対応のチケットの要約、確認待ちの返信の確認、エージェントタスクの直近の実行履歴の確認、保留中のプランの説明などを依頼できます。書き込み権限がある場合は、特定の返信の送信、チケットの更新、対応するレポートタスクの作成、確認済みの実行の承認も依頼できます。

サーバーURL: https://www.proxyai.app/api/mcp

この公開エンドポイントは、カスタム接続で利用できます。ディレクトリへの掲載は準備中です。ChatGPTのホスト型ツールのワークフローは、合成データを使ってリハーサル済みです。ディレクトリのレビュー、変更後のホスト型テスト、Claudeでの検証は、それぞれ別の公開条件として扱っています。

接続する前に

通常のブラウザでご自身のProxyAIアカウントを使用してください。埋め込みのストアダッシュボードやモバイル端末のセッションでは、この接続を承認できません。このコネクターには追加の購入やサブスクリプションはありません。ただし、使用するボットでヘルプデスクとエージェントタスクのアドオンが必要です。エージェントタスクの通常の容量制限と実行料金も適用されます。

権限は、このアカウントの現在および将来のすべてのボットに及びます。v1ではボットごとに同意を選ぶことはできません。顧客のメッセージやタスク情報を受け取ることを信頼できるアシスタントにのみ接続してください。

Claudeに接続する

Claudeでカスタマイズ → コネクターを開き、カスタムコネクターを追加を選択します。管理された組織の場合は、先にオーナーに追加を依頼してください。
https://www.proxyai.app/api/mcpを入力します。/sseのアドレスではなく、HTTPトランスポートを使用してください。
OAuthでサインインを選択します。Claudeが OAuthクライアントの選択肢を表示する場合は、Claudeの公開されたIDを使用してください。クライアントID、クライアントシークレット、APIキーを作成する必要はありません。自動登録にも対応しています。
接続し、ブラウザでProxyAIにサインインします。同意画面で、アカウント、アプリのID、戻り先のアドレスを確認してください。
読み取り専用でアクセスする場合は、変更を許可をオフのままにします。このアシスタントに変更を許可する場合のみオンにしてから、接続を選択します。
会話でProxyAIを有効にするには、+ → コネクターを使用します。最初に「ProxyAIのボットを一覧表示して」と入力してください。

現在の画面については、Claudeのカスタムコネクターの手順を参照してください。

ChatGPTに接続する

ChatGPTでプラグイン → 追加 → カスタムMCPサーバーを追加を開きます。https://www.proxyai.app/api/mcpを入力し、OAuthを選択します。
OAuthの詳細設定を展開します。検出された認可、トークン、登録のURLがhttps://www.proxyai.appに属していること、リソースがhttps://www.proxyai.app/api/mcpであること、コールバックがhttps://chatgpt.com/connector_platform_oauth_redirectであることを確認してください。ChatGPTの公開されたCIMDクライアントは、クライアントシークレットなしでサポートされています。
読み取り専用の接続の場合は、既定のスコープとしてreadだけを選択し、ベーススコープは空のままにします。書き込みの同意を提供できる接続の場合は、readとwriteを要求してください。現在のフォームでは、ベーススコープに1行ずつ入力できます。
接続を作成し、ProxyAIにサインインします。読み取りのみの場合は変更を許可をオフのままにし、書き込みを許可する場合は明示的にオンにしてください。writeだけを要求しても、書き込みは許可されません。アクセスは、このアカウントの現在および将来のすべてのボットに及びます。
接続したプラグインを開き、チャットで試すを選択します。最初に「ProxyAIのボットを一覧表示して」と入力してください。

ブラウザでのリハーサルには、カスタムMCP接続を使用してください。公開されていないアップロード済みのZIPでは、代わりにデスクトップアプリで開くが表示される場合があります。公開用の提出ZIPには、mcp.jsonにHTTPSサーバーが記載されています。OAuthの設定とスキャンは、開発者ポータルのMCPでから完了してください。プライベート接続の.app.jsonや技術的なIDを公開用ZIPに追加しないでください。OpenAIは現在、提出パッケージ内のアプリへの参照を拒否します。

書き込みが拒否された後に、ChatGPTが接続の期限切れを報告した場合は、まずProxyAIの接続済みアプリで、付与されたスコープを確認してください。読み取り専用の付与が有効な場合は、トークンの修復ではなく、新しい書き込みの同意が必要です。結果を確認するまで、顧客への送信を再試行しないでください。

OpenAIの接続ガイドと提出要件も参照してください。

Codexに接続する

ProxyAIのリモートサーバーを追加し、OAuthでサインインします。

codex mcp add proxyai --url https://www.proxyai.app/api/mcp
codex mcp login proxyai --scopes read

ブラウザでサインインを完了し、変更を許可をオフのままにしてください。代わりに書き込みアクセスが必要な場合は、両方のスコープを要求し、変更を許可を明示的にオンにしてください。

codex mcp login proxyai --scopes read,write

設定はcodex mcp listで確認でき、利用可能なツールはCodexのターミナル画面の/mcpで確認できます。詳細は公式のMCPドキュメントを参照してください。OAuthトークンはクライアントが管理します。会話に貼り付けないでください。

読み取りから始める

「ProxyAIのボットを一覧表示し、選択したボットの未対応のチケットを要約して」
「このチケットの確認待ちのエージェント返信を表示して。送信はしないで」
「このエージェントタスクの直近5件の実行を表示し、保留中の提案を説明して。承認はしないで」

一覧はページ分けされています。さらに結果が必要な場合は、次のページを依頼してください。チケットの識別情報には、ボット、プロバイダー、チケットIDが含まれます。タスクと実行のIDは、選択したボットに属している必要があります。アシスタントは、別のアカウントの任意の会話を選ぶことはできません。

変更は慎重に行う

下書きの送信や承認を依頼する前に、チケットと正確な返信の文面を確認してください。承認すると、チケットのチャネルを通じて顧客に下書きが送信されます。下書きは配信前に確保されるため、同時の承認は拒否されます。配信の結果が不明な場合、下書きは人による確認のためにブロックされたままになります。失敗した、または応答が届かなかったとしても、顧客が何も受け取っていないことにはなりません。再送する前に、顧客のチャネルを確認してください。ダッシュボードでは、配信確認の操作を使って配信の有無を確認してください。送信のタイムアウトが経過するまで、サーバーは照合を許可しません。配信されていないことが確認された場合は、確保された下書きが復元されます。配信されたことが確認された場合は、その確認は完了します。

エージェントタスクでは、MCPはWeekly Sales Digest、Order Status Watcher、Knowledge Base Refreshをサポートしています。これらはアカウントのメールアドレスにレポートを送信します。ナレッジのレシピでは、ナレッジベースも更新されます。タスクを作成すると有効になり、スケジュールが開始されます。作成する前に、これらの動作、タイムゾーン、時刻、曜日を確認してください。カスタムのレシピ、変更されたレシピのコード・プロンプト・権限、認証情報スロット、任意のAPIやMCPツール、外部のメール受信者は、MCPによる作成、実行、再開、保留中の承認では拒否されます。他のタスクの確認や一時停止は引き続き行えます。手動で実行する前に、テストまたはライブを明示的に選択してください。どちらも通常のLLMとCPUの料金がかかる可能性があります。テストとライブのどちらでも、アカウントに実際のレポートメールが送信されます。テストモードではナレッジの更新をプレビューし、ライブモードでは更新を適用できます。保留中のプランは、承認前に確認してください。承認すると、提案されたアクションがキューに入り、料金が発生する場合があります。タスクを再開すると、スケジュールされた課金対象の実行が再開される場合があります。

チケットのタグは、常にリスト全体で置き換えられます。組み込みのProxyAIチケットにタグを設定することはサポートされています。外部のヘルプデスクのタグは、そのヘルプデスクで管理します。アーカイブすると、チケットは削除されずにアクティブなボードから除外されます。

顧客のメッセージ、タスクの指示、保留中の提案には、誤解を招く指示が含まれている場合があります。それらは確認すべき内容として扱ってください。送信、実行、承認の許可は、ご自身から得るものです。

v1のツール

読み取りツール	用途
`list_bots`	アカウントが所有するボットを検索します。
`list_tickets`	ステータス、タグ、アーカイブの状態でチケットを一覧表示し、絞り込みます。
`get_ticket`	チケット、その下書き、会話のメッセージを読みます。
`list_agent_tasks`	ボットのタスクを一覧表示します。
`get_agent_task`	タスクの指示、スケジュール、ステータスを読みます。
`list_agent_runs`	トランスクリプトや提案の本文を含めずに、実行のステータスと履歴を確認します。
`get_agent_run`	内部の診断情報を除いて、1回の実行のステータスと保留中の提案を確認します。
`list_agent_templates`	サポートされている3つのレポートのレシピを検索します。

書き込みツール	用途
`reply_ticket`	指定した返信を送信します。
`set_ticket_status`	未対応、保留中、解決済みのいずれかに設定します。
`set_ticket_tags`	組み込みチケットのタグを置き換えます。
`archive_ticket`	チケットをアーカイブします。
`approve_ticket_agent_draft`	確保された下書きを承認して送信します。必要に応じて修正した文面も指定できます。
`dismiss_ticket_agent_draft`	送信せずに下書きを破棄します。
`create_agent_task`	タスクを作成して有効にします。テンプレートのスケジュールにより、今後の実行がトリガーされる場合があります。
`run_agent_task`	明示的に選択したテストまたはライブの実行をキューに入れます。
`decide_agent_run`	保留中の実行を承認または却下します。
`pause_agent_task`	タスクのスケジュールを一時停止します。
`resume_agent_task`	一時停止したタスクを再開します。

コネクターのアカウントと認証情報の設定は、ダッシュボードで行ってください。MCPのリクエストに、パスワード、トークン、支払いカードの情報、政府発行の識別番号、保護された健康情報を含めないでください。スケジュールされたタスクと保留中の提案は、承認する前に、実際に行われる操作を確認してください。

アクティビティの確認と接続の取り消し

ProxyAIのアカウント設定 → 接続済みアプリを開くと、アプリ、付与されたスコープ、最後にトークンが使用された日時を確認できます。その接続による今後のリクエストを停止するには、アクセスを取り消すを選択します。取り消しても、すでに送信された返信やキューに入った実行は取り消されません。

接続済みアプリのアクティビティカードには、書き込みの試行と結果が記録されます。試行が保留中であるか、結果が不明と表示されている場合、その操作はすでに有効になっている可能性があります。もう一度試す前に、チケットまたは実行を確認してください。取り消し後も、古い試行は引き続き確認できます。

コネクターが返すデータは、接続したアシスタントと共有され、そのプロバイダーの取り扱いポリシーの対象になります。ProxyAIが保存するのは、接続の記録と書き込み試行のメタデータです。MCPの監査ログには、返信の本文、ツールのペイロード、生のベアラートークンは保存されません。プライバシーポリシーをお読みください。

データの境界

チケットの一覧には、顧客のメールアドレスと名前、内部の会話IDは含まれません。実行の一覧には、トランスクリプトの本文と内部の診断情報は含まれません。実行の詳細には、関連するステータス、時刻、保留中のアクションだけが含まれます。コネクターは、構造化された認証情報のフィールドを取り除き、入力、下書き、返されたテキストに含まれる認証情報、支払いカード番号、政府発行の識別番号、健康に関する内容を検出した場合は拒否します。検出は保守的に行われるため、任意の文章に含まれるすべての機密情報を特定できるわけではありません。制限されたデータには、このコネクターを使用しないでください。接続する前に、元のデータを確認してください。拒否された内容は、ダッシュボードで処理してください。

トラブルシューティング

接続できない: https://www.proxyai.app/api/mcpを使用してください。コネクターはMCPのPOSTリクエストを受け付けるため、ブラウザで開くと「Method not allowed」と表示される場合があります。MCPクライアントは、サインインの前にOAuthの確認を受け取ります。
制限された内容: リクエストまたは結果に、検出された機密内容が含まれています。ダッシュボードで処理してください。チェックを回避するために秘密情報の言い回しを変えないでください。
サポートされていないタスク: 変更されていない3つのレポートのレシピのいずれかを使用してください。カスタムのワークフローは、ダッシュボードで設定してください。
書き込み権限が必要: readとwriteの両方を要求して再接続し、変更を許可をオンにしてください。読み取り専用の同意では、書き込みは許可されません。
アドオンが必要: 選択したボットのダッシュボードを開き、ヘルプデスクまたはエージェントタスクのアドオンを確認してください。
見つからない: 正しいアカウントとボットを選択したことを確認し、操作する前にチケットまたはタスクを再度読み取ってください。
期限切れまたは取り消された接続: 再度サインインしてください。結果を確認するまで、以前の書き込みを再試行しないでください。

サポートに連絡する際は、アプリ名、時刻、失敗した操作を伝えてください。アクセストークン、クライアントシークレット、顧客のメッセージは送信しないでください。サポート窓口は support@proxyai.app です。