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

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

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

- **エンドポイント:** `https://mcp.youraiconnector.com/mcp`
- **認証:** <span data-t="appName">DM Champ</span> API キー（`X-API-Key` ヘッダーとして送信）
- **要件:** API アクセス権を持つプラン。[API キーを作成する →](api-access.md#generating-your-api-key)

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

## Claude Code

```bash
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` を使用してください。

```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` を編集し（設定 → 開発者 → 設定を編集）、以下を追加します。

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

Claude Desktop を再起動します。<span data-t="appName">DM Champ</span> ツールがツールメニューに表示されます。

## ChatGPT

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

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

- **URL:** `https://mcp.youraiconnector.com/mcp`
- **認証:** カスタムヘッダー
- **ヘッダー名:** `X-API-Key`
- **ヘッダー値:** <span data-t="appName">DM Champ</span> 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 サーバーに接続することもできます。これにより、構築したエージェントが別のクライアントを介さずに <span data-t="appName">DM Champ</span> ツールを使用できるようになります：

```json
{
  "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](../agency/api-for-agencies.md)から実行してください。

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

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

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

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

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

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

- **「コネクタ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アクセス](api-access.md) — この接続で使用するキーの生成やローテーションを行います。
- [Webhooks](webhooks.md) — このプル型MCP接続に対するプッシュ型の対照機能です。