AIアシスタントの接続 (MCP)

DM Champ は、公式の MCP サーバー（Model Context Protocol エンドポイント）を提供しています。これを使用すると、Claude Code、Claude Desktop、ChatGPT、Cursor、および独自のアプリケーションなどの AI アシスタントから、DM Champ アカウントを直接操作できるようになります。自然言語で質問するだけで（「ライブキャンペーンを一覧表示して」、「このリードを追加して」、「今週の AI 利用料金はいくら？」など）、アシスタントが代わりに DM Champ API を呼び出します。

これはAPIセクションで文書化されているv1 APIと同じもので、独自のAPIキーで認証されます。MCPサーバーは、公開されているAPI仕様の各操作に対して1つのツールを構築するため、v1 APIのすべてではありませんが、連絡先、メッセージ、キャンペーン、AIエージェント、ナレッジベース、予約、分析、タグ、リスト、サブアカウントなど、ほとんどをカバーしています。ブロードキャスト、オートメーション、取引はまだMCPツールとして利用できません。これらについてはREST APIを直接使用してください。公開されている範囲内では、ツールごとの権限やデフォルトの読み取り専用設定はないため、APIキーがすべてのアクセス制御となります。

エンドポイント: https://mcp.youraiconnector.com/mcp
認証: DM Champ API キー（X-API-Key ヘッダーとして送信）
要件: API アクセス権を持つプラン。API キーを作成する →

APIキーはあなた自身のアカウントに対して機能し、APIの他の部分と同じ権限を持ちます。エージェンシープランをご利用の場合は、管理しているクライアントアカウントも読み取ることができます（下記参照）。パスワードのように扱ってください。「設定」→「統合」→「APIキー」からいつでも取り消すことができ、その時点でアシスタントのアクセスは即座に遮断されます。

Claude Code

claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

次に、Claude Code内で /mcp を実行し、dm-champ ✓ connected と表示されることを確認します。

デフォルトでは、サーバーはローカルスコープ（あなた自身、およびこのプロジェクトのみ）に追加されます。すべてのプロジェクトで利用可能にするには --scope user を使用し、チーム全体で利用するには --scope project to commit it to a repo’s .mcp.json を使用してください。

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

claude_desktop_config.json を編集し（設定 → 開発者 → 設定を編集）、以下を追加します。

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop を再起動します。DM Champ ツールがツールメニューに表示されます。

ChatGPT

カスタムMCPコネクタは、ChatGPT Business、Enterprise、およびProで利用可能です。ワークスペースのオーナーまたは管理者が、最初にワークスペース設定で開発者モード / カスタムコネクタを有効にする必要があります。これを有効にしないと、コネクタを作成するオプションが表示されません。

次に、以下の設定でコネクタを作成します。

URL: https://mcp.youraiconnector.com/mcp
認証: カスタムヘッダー
ヘッダー名: X-API-Key
ヘッダー値: DM Champ API キー

URLは必ず/mcpで終わる必要があります。https://mcp.youraiconnector.comのみを貼り付けるのが最も一般的な間違いです。ChatGPTはその正確なアドレスを確認し、何も見つからない場合に**「Unable to add connector URL（コネクタURLを追加できません）」**と表示します。

Cursorおよびその他のMCPクライアント

ほとんどのMCP対応エディタは、上記と同じ .mcp.json 形式（url と X-API-Key ヘッダーを持つHTTPサーバー）を使用します。https://mcp.youraiconnector.com/mcp を指す dm-champ サーバーを追加し、ヘッダーにAPIキーを貼り付けてください。

Claude API（独自のアプリへの組み込み）

Claude API の MCP コネクタを使用して、プログラムから MCP サーバーに接続することもできます。これにより、構築したエージェントが別のクライアントを介さずに DM Champ ツールを使用できるようになります：

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}

できること

MCP サーバーが公開する v1 API の範囲内で、アシスタントが適切なツールを自動的に選択します。

キャンペーン： 一覧表示、作成、更新、一時停止/再開、ボット設定の確認。
連絡先： 検索、作成、タグ付け、リストへの追加、インポート。
ナレッジベース / FAQ： 追加、編集、一括インポート、AI提案の承認。
メッセージ： 会話の読み取り、連絡先へのメッセージ送信。
予約： 一覧表示、予約、キャンセル。
タスク： 作成、完了、一覧表示。
分析： メッセージ統計、クレジット使用量、AIコスト。
チャネル： 接続ステータスの確認、接続フローの開始。

クライアントのアカウントについて質問する（エージェンシー向け）

1つの接続ですべての管理アカウントをカバーします。クライアントごとに2つ目の接続を追加する必要はありません。エージェンシープランでは、アシスタントは配下のどのクライアントアカウントも読み取ることができるため、1つの会話ですべてのアカウントについて質問できます。

クライアント名を指定するだけです：

「Bella’s Bistroには連絡先がいくつありますか？」
「今週、各クライアントのAI利用料はいくらでしたか？」
「Northside Dentalで現在稼働中のキャンペーンは何ですか？また、彼らのチャネルの状態はどうなっていますか？」

これには、連絡先、メッセージ、チャット、キャンペーン、予約、タスク、タグ、イベント、FAQ、ナレッジベースのソース、電話番号、チャネル、Webhook、分析の読み取りが含まれます。実行前にそのアカウントが実際にあなたのものであることを確認します。あなたのものではないアカウントを要求した場合は「見つかりません」と返されます。クライアントを指定しない場合、アシスタントはこれまで通りあなた自身のアカウントを読み取ります。

クライアントのアカウントの変更には制限があります。AIエージェント、カスタム関数、WhatsAppテンプレート、エントリーポイント、チャネル接続、キャンペーンステータス、電話番号の購入の設定はすべて特定のクライアントに対して機能しますが、その他の書き込み操作のほとんどは引き続き自身のアカウントで実行されます。そのため、それらの操作はクライアント自身のキーから、またはより広範囲をカバーするREST APIから実行してください。

これは、1つのログインで複数のビジネスを運営しているクライアントへの回答でもあります。各ビジネスに個別のカウントを与え、クライアントのメールアドレスをすべてのビジネスのチームメンバーとして招待してください。クライアントは一度サインインすれば、サイドバーのアカウントピッカーでブランドを切り替えることができます。

アシスタントにヘルプドキュメントを提供する

MCPサーバーは、アシスタントにあなたのアカウントへのアクセス権を付与しますが、このドキュメントへのアクセス権は付与しません。アシスタントに「…するにはどうすればよいですか？」という質問にも正しく回答させたい場合は、https://docs.youraiconnector.com/llms.txt（各ヘルプページのMarkdown版へのリンクを含むインデックス）またはhttps://docs.youraiconnector.com/llms-full.txt（ドキュメント全体をまとめたMarkdownファイル）を指定してください。どちらも公開されており、キーは不要で、ドキュメントが更新されるたびに再構築されます。詳細はMarkdownとしてドキュメントを読むを参照してください。

APIキーの検索または生成

この接続で使用するAPIキーは、Webhooksとは別のセクションである**「設定」→「統合」→「APIキー」**にあります。正確な手順については、APIアクセスを参照してください。

トラブルシューティング

「コネクタURLを追加できません」(ChatGPT) / 「接続が拒否されました」 — アドレスの末尾に /mcp が不足しています。https://mcp.youraiconnector.com ではなく https://mcp.youraiconnector.com/mcp を使用してください。
Needs authentication / 401 — APIキーが不足しているか、間違っています。有効な X-API-Key を使用してサーバーを再度追加してください。
ツールが 403 を返す — ご利用のプランやチームの役割ではその操作が許可されていません。MCPサーバー側で追加の制限を設けているわけではなく、APIと同じ権限チェックが行われます。
ツールが見つかりません — ツールリストはAPIからライブで生成されるため、常に現在のバージョンと一致します。再接続して更新してください。
独自のドメインでセキュリティや証明書の警告が出る — DNSレコードを弊社に向けるだけでは不十分です。セキュアな接続を提供するには、ダッシュボードでサブドメインの検証も行う必要があります。ホワイトラベル代理店は、Settings → White Labeling の Custom domain カードから、MCPアドレスを独自のドメイン（例: mcp.youragency.com）に設定できます。まずレジストラでCNAMEを追加し、次に MCP domain (AI assistants) ブロックにホスト名を入力して Verify をクリックしてください。これは他のブランドサブドメインと同じ手順です。検証が完了するまでは、上記の標準アドレスを使用してください。これはブランド名が含まれていないため、クライアントと共有しても安全です。

次のステップ

APIアクセス — この接続で使用するキーの生成やローテーションを行います。
Webhooks — このプル型MCP接続に対するプッシュ型の対照機能です。

AIアシスタントの接続 (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursorおよびその他のMCPクライアント #

Claude API（独自のアプリへの組み込み） #

できること #

クライアントのアカウントについて質問する（エージェンシー向け） #

アシスタントにヘルプドキュメントを提供する #

APIキーの検索または生成 #

トラブルシューティング #

次のステップ #