AIアシスタントの接続 (MCP)
DM Champ は、公式の MCP サーバー(Model Context Protocol エンドポイント)を提供しています。これを利用することで、Claude(claude.ai および Claude Desktop)、ChatGPT、Claude Code、Cursor、そしてあなた自身のアプリといった AI アシスタントから、直接 DM Champ アカウントを操作できるようになります。自然言語で指示を出すだけで(例:「AI エージェントを一覧表示して」、「このリードを追加して」、「今週の AI 利用料金はいくら?」など)、アシスタントがあなたの代わりに DM Champ API を呼び出します。
これは、API キー で利用するのと同じ v1 API です。アカウントにサインインして 許可 (Allow) をクリックするか、独自の API キーを使用して接続します。MCP サーバーは、公開されている API 仕様の各操作に対して 1 つのツールを構築するため、v1 API のほとんど(すべてではありません)をカバーしています。対象となるのは、連絡先、メッセージ、キャンペーン、AI エージェント、カスタム関数、ナレッジベース、予約、分析、タグ、リスト、ブロードキャスト、取引、チャネル接続、サブアカウント、自動化です。アシスタントが作成した自動化は、最初はオフの状態でドラフトとして保存され、個別の手順で有効にすることで初めて実行されます(自動化 API を参照)。 公開されている機能にはツールごとの権限設定やデフォルトの読み取り専用設定はないため、サインイン(または API キー)がアクセス制御のすべてとなります。
- エンドポイント:
https://mcp.youraiconnector.com/mcp - 認証:
X-API-Keyヘッダーとして DM Champ アカウントでサインインするか、API キーを使用します - 要件: API アクセス権のあるプラン。API キーを作成 →
DM Champ では代わりに https://mcp.youraiconnector.com/mcp を使用できます。同じアカウント、同じサインイン、同じキーが利用可能です。そのアドレスでは、アシスタントの組み込みヘルプドキュメントに、請求や代理店向けのガイド、LinkedIn に関するドキュメントも含まれています。
接続は あなた自身のアカウント に対して行われ、API キーと同じ権限を持ちます。代理店プランをご利用の場合は、管理しているクライアントアカウントも読み取ることができます(下記参照)。API キーはパスワードと同様に扱ってください。サインインまたはキーによるすべての接続は、「設定 (Settings) → 統合 (Integrations) → API キー (API Key)」に一覧表示され、そこで取り消すことでアシスタントのアクセスを遮断できます。
Claude Code
手っ取り早い方法:DM Champプラグイン
このプラグインは接続をセットアップし、Claudeが最初に読み込むスキルとプレイブックを追加します。DM Champの構成、一般的なワークフローのステップバイステップガイド、および実行前に確認が必要な事項(実際のユーザーへのメッセージ送信、取り消し不可能な操作、クレジットの消費など)が含まれています。
claude plugin marketplace add dm-champ/claude-plugin
claude plugin install dm-champ@dm-champ
次に claude を起動し、/plugin configure dm-champ@dm-champ を実行して API キーを貼り付けます。キーはファイルではなく、システムのキーチェーンに保存されます。Claude Code を再起動し、/mcp を実行してサーバーへの接続を確認したら、質問を開始してください。
このプラグインは Claude Code ターミナルアプリで動作します。削除するには、claude plugin uninstall dm-champ@dm-champ を実行してください。
プラグインを使用しない場合
claude mcp add --transport http ai-connector https://mcp.youraiconnector.com/mcp \
--header "X-API-Key: YOUR_API_KEY"
次に、Claude Code内で/mcpを実行し、ai-connector ✓ connectedと表示されることを確認します。
デフォルトでは、サーバーはローカルスコープ(あなた自身、およびこのプロジェクトのみ)に追加されます。すべてのプロジェクトで利用可能にするには --scope user を使用し、チーム全体で利用するには --scope project to commit it to a repo’s .mcp.json を使用してください。
{
"mcpServers": {
"ai-connector": {
"type": "http",
"url": "https://mcp.youraiconnector.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
Claude (claude.ai および Claude Desktop)
サーバーをカスタムコネクタとして追加し、DM Champ アカウントでサインインします。これは claude.ai ウェブサイトおよび Claude Desktop アプリで動作します(無料の Claude アカウントでも 1 つのカスタムコネクタを追加できます)。
- Customize → Connectors を開き、+ Add をクリックしてから Add custom connector を選択します。
- 名前を付け、URL に
https://mcp.youraiconnector.com/mcpを入力して Continue をクリックします。 - Authentication を Sign in now のままにするか、Sign in when needed を選択し、Add をクリックします。
- 新しいコネクタの横にある Connect をクリックします。DM Champ のログインページが開きます。ログインしていない場合はログインしてください。
- Claude wants to connect to your account と表示されます。Allow をクリックすると Claude に戻ります。新しいチャットのツールメニューに DM Champ ツールが表示されます。
この接続は、代理店プランで管理しているクライアントアカウントを含め、API キーで可能なすべての操作を実行できます。ツールごとの権限設定はありません。接続は 設定 (Settings) → 統合 (Integrations) → API キー (API Key) に Claude (signed in) という名前のキーとして表示され、サインインするたびにエントリが追加されます。Claude の接続を切断するにはそのキーを取り消してください。次回の要求時にアクセス権が失われます。Claude 上でコネクタを削除しただけではリストにキーが残るため、必ずそちらでも取り消しを行ってください。
接続を許可できるのはアカウント所有者のみです。チームメンバーやクライアントのアカウント内で作業している代理店の担当者は、所有者としてログインするよう求められます。アカウントには API アクセス権のあるプランが必要です。
API キーを使用した Claude Desktop の接続
Claude Desktop は、サインインせずにリクエストヘッダーに API キーを含めて接続することも可能です。
- カスタマイズ (Customize) → コネクタ (Connectors) を開き、+ 追加 (+ Add) をクリックしてから カスタムコネクタを追加 (Add custom connector) をクリックします。
- 名前を付け、URL に
https://mcp.youraiconnector.com/mcpを入力します。 - 認証 (Authentication) で サインインなし (No sign-in) を選択します。
- リクエストヘッダー (Request headers) で、ヘッダー名に
X-API-Keyを指定し、値に API キーを入力します。 - 追加 (Add) をクリックします。
claude.ai ウェブサイトには リクエストヘッダー フィールドがないため、ウェブサイト上では上記のサインイン手順を使用してください。
「リクエストヘッダー」フィールドがありませんか? Claude Desktopのバージョンが古い可能性があります。アップデートするか、代わりに設定ファイルを使用してください。設定ファイル(claude_desktop_config.json、設定 → 開発者 → 設定を編集)はコンピューター上のプログラムのみを実行し、url エントリを無視するため、小さな mcp-remote ブリッジが必要です。これには Node.js 18以降が必要です。
{
"mcpServers": {
"ai-connector": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.youraiconnector.com/mcp",
"--header",
"X-API-Key:${AI_CONNECTOR_KEY}"
],
"env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" }
}
}
}
X-API-Key:${AI_CONNECTOR_KEY} はコロンの後にスペースを入れず(Windowsではスペースを入れるとヘッダーが分割されます)、そのまま記述してください。また、キーは env にのみ入力してください。その後、Claude Desktopを完全に終了し(Windowsの場合はトレイアイコンを右クリック → 終了)、再度開いてください。
ChatGPT
ChatGPT も同様に、サインインすることで接続できます。
- ChatGPTのコネクタ設定で、
https://mcp.youraiconnector.com/mcpをURL、OAuthを認証方式としてカスタムコネクタを作成します。 - ChatGPTが接続すると、DM Champのログインページが開きます。ログインしていない場合はログインしてください。
- ChatGPTがあなたのアカウントへの接続を求めていますと表示されます。許可をクリックすると、ChatGPTに戻ります。
Claudeと同様に、接続にはAPIキーの権限が適用されます。設定 → 統合 → APIキーにアプリ名でキーが表示され、そのキーを取り消すことで切断できます。アカウント所有者のみが許可でき、アカウントにはAPIアクセス権のあるプランが必要です。
Cursorおよびその他のMCPクライアント
Cursorやその他のMCP対応エディタは、引き続きAPIキーを使用します。その形式は上記の.mcp.jsonと同じです(urlとX-API-Keyヘッダーを持つHTTPサーバー)。https://mcp.youraiconnector.com/mcpを指すai-connectorサーバーを追加し、ヘッダーにAPIキーを貼り付けてください。
Claude API(独自のアプリへの組み込み)
Claude API の MCP コネクタを使用して、プログラムから MCP サーバーに接続することもできます。これにより、構築したエージェントが別のクライアントを介さずに DM Champ ツールを使用できるようになります:
{
"model": "claude-opus-4-8",
"messages": [{ "role": "user", "content": "List my AI agents" }],
"mcp_servers": [
{
"type": "url",
"name": "ai-connector",
"url": "https://mcp.youraiconnector.com/mcp",
"authorization_token": "YOUR_API_KEY"
}
]
}
できること
MCP サーバーが公開する v1 API の範囲内で、アシスタントが適切なツールを自動的に選択します。
- AI エージェント: 一覧表示、作成、更新、一時停止/再開、設定の確認。
- 連絡先: 検索、作成、タグ付け、リストへの追加、インポート。
- ナレッジベース / FAQ: 追加、編集、一括インポート、AI 提案の承認。
- メッセージ: 会話の読み取り、連絡先へのメッセージ送信。
- 予約: 一覧表示、予約、キャンセル。
- タスク: 作成、完了、一覧表示。
- 分析: メッセージ統計、クレジット使用量、AI コスト。
- チャネル: 接続状態の確認、接続フローの開始。
クライアントのアカウントについて質問する(エージェンシー向け)
1つの接続ですべての管理アカウントをカバーします。クライアントごとに2つ目の接続を追加する必要はありません。エージェンシープランでは、アシスタントは配下のどのクライアントアカウントも読み取ることができるため、1つの会話ですべてのアカウントについて質問できます。
クライアント名を指定するだけです:
- 「Bella’s Bistro には連絡先がいくつありますか?」
- 「今週、各クライアントの AI 利用料金はいくらでしたか?」
- 「Northside Dental のチャネルの状態はどうなっていますか?また、今週は何件のチャットがありましたか?」
これには、連絡先、メッセージ、チャット、キャンペーン、予約、タスク、タグ、イベント、FAQ、ナレッジベースのソース、電話番号、チャネル、Webhook、分析の読み取りが含まれます。実行前にそのアカウントが実際にあなたのものであることを確認します。あなたのものではないアカウントを要求した場合は「見つかりません」と返されます。クライアントを指定しない場合、アシスタントはこれまで通りあなた自身のアカウントを読み取ります。
クライアントのアカウントの変更も同様の手順で行えます。APIでクライアントアカウントを受け入れるすべてのアクションは、指定されたクライアントに対して利用可能です。これには、AIエージェント、ナレッジベース、カスタム関数、WhatsAppテンプレート、エントリーポイント、チャネル接続、連絡先、タグ、ブロードキャスト、予約、案件とタスクの設定、およびメッセージの送信が含まれます。例外となるのはエージェンシーレベルのアクションで、これらは常にあなた自身のエージェンシーアカウントで実行されます。具体的には、クライアントアカウント自体の管理(制限、機能、価格設定、一時停止)、スナップショット、チーム、およびAPIキーの管理です。クライアントのリストへの連絡先の追加や削除は、指定されたクライアントに対してはまだ利用できません。これらは、そのクライアント自身のキーを使用するか、クライアントのアカウント内で行ってください。サポートされている内容については、エージェンシーAPIガイドを参照してください。
エージェンシー向けツールは、標準のブランド名なしのアドレス https://mcp.youraiconnector.com/mcp でのみ利用可能です。独自のドメイン上のホワイトラベルMCPアドレス (mcp.youragency.com) はクライアント向けに構築されており、エージェンシー向けツールは含まれていません。そのため、クライアントアカウントを管理する際は、標準のブランド名なしのアドレスに接続してください。
これは、1つのログインで複数のビジネスを運営しているクライアントへの回答でもあります。各ビジネスに個別のカウントを与え、クライアントのメールアドレスをすべてのビジネスのチームメンバーとして招待してください。クライアントは一度サインインすれば、サイドバーのアカウントピッカーでブランドを切り替えることができます。
クライアントのエージェントをテストする
アシスタントにクライアントのエージェントを試すよう依頼します(例:「クライアントXのBakeryエージェントに『日曜日は配達していますか?』と送信し、その結果を表示して」)。これにより、あなたのエージェンシーキーとクライアントのsub_account_idを使用して「試用(Try Out)」メッセージが送信され、待機した後に返信内容とエージェントが実行したアクションが読み取られます。エージェントのコピーは必要ありません。アシスタントがエージェンシーアカウントではないと回答した場合は、クライアントのキーで接続されている状態です。エージェンシーアカウントのキーで再接続してください。詳細は試用(Try Out)を参照してください。
ツール数に制限があるクライアント
一部のAIクライアントは、ツール数が制限されたサーバーのみを受け入れます。例えばComposioは、500個を超えるツールをリストするサーバーを拒否し、ツールを一切インポートしません。エージェンシーのフル接続ではそれ以上のツールがリストされるため、必要なツールグループのみを指定してアドレスに ?tags= を追加してください。
クライアントアカウントのリスト表示、連絡先・チャット・メッセージの読み取り、およびメッセージ送信を行うエージェンシーの場合:
https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages
これにより約80個のツールが読み込まれます。リクエスト内でクライアント名を指定すると、前述の通り、アシスタントはそのクライアントのアカウントに対して操作を行います。
- グループはカンマで区切ってください。大文字と小文字のどちらでも機能します。
- 単一のツールを追加するには、
tools=を使用して正確な名前をリストします(例:?tags=Contacts&tools=list_or_get_subaccounts)。どちらのリストからもすべてのツールを取得できます。 - ヘルプドキュメントのツールは常に含まれます。
- APIキーは常に
X-API-Keyヘッダー(またはAuthorization: Bearer YOUR_API_KEY)に含める必要があり、アドレスには決して含めないでください。
ヘルプドキュメントは組み込み済みです
MCPサーバーは、アシスタントにあなたの アカウント 情報とこの ドキュメント を提供します。3つのツールがヘルプドキュメントをライブで読み取るため、アシスタントは推測する代わりに、機能の仕組みや最近の変更点を調べることができます:
docs_search: 質問に対する回答となるセクションを見つけ、ページリンクと共に返します。docs_read: 1ページ全体、またはそのセクションを読み取ります。docs_list: エリアごとに全ページを一覧表示します。
セットアップは不要で、ドキュメントツールがアカウントデータに触れることはありません。「エントリーポイントはどのように機能しますか?」や「オートメーションの最新情報は?」と尋ねれば、アシスタントはまずドキュメントを検索します。ツールがヘルプサイト自体を読み取るため、ガイドが公開され次第、アシスタントはその機能を認識できるようになります。
MCP経由で接続されていないアシスタントでも、ドキュメントを読み取ることができます。https://docs.dmchamp.com/llms.txt(各ページのMarkdown版へのリンクを含む全ヘルプページのインデックス)または https://docs.dmchamp.com/llms-full.txt(ドキュメント全体をまとめた1つのMarkdownファイル)を指定してください。どちらも公開されており、キーは不要で、ドキュメントが更新されるたびに再構築されます。
APIキーの検索または生成
この接続で使用するAPIキーは、Webhooksとは別のセクションである**「設定」→「統合」→「APIキー」**にあります。正確な手順については、APIアクセスを参照してください。
トラブルシューティング
- “Connection refused” または “not found” — アドレスの末尾に
/mcpが不足しています。https://mcp.youraiconnector.comではなくhttps://mcp.youraiconnector.com/mcpを使用してください。 Needs authentication/ 401 — APIキーが不足しているか間違っているか、サインインによって作成されたキーが無効化されています。有効なX-API-Keyでサーバーを再追加するか、再度サインインしてください。- “Your plan does not include API access, which connecting an AI app needs” — 接続にはAPIキーと同様に、APIアクセス権を持つプランが必要です。プランをアップグレードしてから、AIアプリから接続をやり直してください。
- “Only the account owner can connect an AI app” — チームメンバーとしてログインしているか、代理店としてクライアントのアカウント内で作業しています。アカウントの所有者のログイン情報でログインし、接続をやり直してください。
- “This link no longer works” — サインインページの有効期限が切れたか(10分間有効)、既に使用済みです。AIアプリから接続をやり直してください。
- claude.ai でコネクタを追加した直後の “Connection issue” — サインインページが開かなかった(ポップアップがブロックされたなど)可能性があります。そのページの Reconnect をクリックするとサインインページが開きます。
- “Add anyway” の後に claude.ai で接続が失敗する — コネクタが No sign in で追加されており、ウェブサイトがAPIキーを送信できません。削除して、Claude のように Sign in now で再度追加してください。
- Claude、ChatGPT、またはその他のサインイン済みアプリの接続を解除するには — Settings → Integrations → API Key で、アプリ名が付いたキー(例: Claude (signed in))を取り消します。アプリは次のリクエスト時にアクセス権を失います。
- 設定ファイルを編集しても Claude Desktop にツールが表示されない — 設定ファイルが
"url"エントリを無視しています。カスタムコネクタまたは Claude のmcp-remoteフォームを使用し、アプリを完全に終了してから再起動してください。 - ツールが
403を返す — プランまたはチームの役割がそのアクションを許可していません。MCPサーバーは追加の制限を課しておらず、APIと同じ権限チェックが行われます。 - Tool not found — ツールリストはAPIからライブで生成されるため、常に現在のバージョンと一致します。再接続して更新してください。
- 独自のドメインでのセキュリティまたは証明書警告 — DNSレコードを弊社に向けるだけでは不十分です。安全な接続を提供するには、ダッシュボードでサブドメインも検証する必要があります。ホワイトラベル代理店は、Settings → White Labeling の Custom domain カードから、MCPアドレスを独自のドメイン(例:
mcp.youragency.com)に設定できます。まずレジストラでCNAMEを追加し、次に MCP domain (AI assistants) ブロックにホスト名を入力して Verify をクリックしてください。これは他のブランド化されたサブドメインと同じフローです。ブランド化されたアドレスには代理店用ツールは含まれません。それらには引き続き標準のブランド化されていないアドレスを使用してください。ブランド化されたアドレスが検証されるまでは、標準のブランド化されていないアドレスを使用してください。クライアントと共有しても安全です。