DirectIQ

DirectIQ MCP サーバー

Claude、ChatGPT、Cursor、VS Code、Windsurf、その他のあらゆるModel Context Protocolクライアントを、お使いのDirectIQアカウントに接続できます。連絡先、リスト、タグを管理し、アカウントの概要を確認して、平易な言葉でトランザクションメールを送信できます。

DirectIQは、小規模事業者向けのメールマーケティングおよびトランザクションメールプラットフォームです。迅速な有人サポートを提供し、従量課金制の料金体系を採用しています。→ directiq.com

• エンドポイント： https://mcp.directiq.com/mcp
• トランスポート： Streamable HTTP（リモート、DirectIQ がホスト。インストール不要）
• 認証： x-api-key ヘッダー内の DirectIQ API キー、または Authorization: Bearer <key>（OAuth は近日対応予定）
• サーバーカード： https://mcp.directiq.com/.well-known/mcp/server-card.json
• レジストリ名： com.directiq.mcp/directiq

このリポジトリには、DirectIQ が運用する mcp.directiq.com 上のホスト型 DirectIQ MCP サーバーの公開ドキュメント、レジストリメタデータ、クライアント設定が含まれています。インストールやビルドは不要です。

クイックスタート

1. API キーを取得する： DirectIQ ダッシュボードにログインし、Settings → API Keys に移動して、キーをコピーするか生成します。まだアカウントをお持ちでない場合は、無料で登録してください。
2. サーバーをクライアントに追加する： 以下の設定例を参照してください。
3. プロンプトを試す： 「DirectIQ アカウントの概要を教えてください。」

クライアントのセットアップ

Cursor

Cursor に追加。このリンクを開くと、設定が入力された状態で Cursor が起動します。YOUR_DIRECTIQ_API_KEY をご自身のキーに置き換えてください。

または、~/.cursor/mcp.json に手動で追加します。

{
  "mcpServers": {
    "directiq": {
      "url": "https://mcp.directiq.com/mcp",
      "headers": { "x-api-key": "YOUR_DIRECTIQ_API_KEY" }
    }
  }
}

VS Code（GitHub Copilot）

.vscode/mcp.json に追加します。VS Code がキーの入力を求め、安全に保存します。

{
  "inputs": [
    { "type": "promptString", "id": "directiq_api_key", "description": "DirectIQ API key", "password": true }
  ],
  "servers": {
    "directiq": {
      "type": "http",
      "url": "https://mcp.directiq.com/mcp",
      "headers": { "x-api-key": "${input:directiq_api_key}" }
    }
  }
}

Claude Code

claude mcp add --transport http directiq https://mcp.directiq.com/mcp --header "x-api-key: YOUR_DIRECTIQ_API_KEY"

Claude Desktop

OAuth が提供されるまでは、claude_desktop_config.json で mcp-remote ブリッジを使用してください。

{
  "mcpServers": {
    "directiq": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.directiq.com/mcp", "--header", "x-api-key:${DIRECTIQ_API_KEY}"],
      "env": { "DIRECTIQ_API_KEY": "YOUR_DIRECTIQ_API_KEY" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "directiq": {
      "serverUrl": "https://mcp.directiq.com/mcp",
      "headers": { "x-api-key": "YOUR_DIRECTIQ_API_KEY" }
    }
  }
}

OpenAI Codex

export DIRECTIQ_API_KEY=... を設定してから、~/.codex/config.toml を編集します。

[mcp_servers.directiq]
url = "https://mcp.directiq.com/mcp"
env_http_headers = { "x-api-key" = "DIRECTIQ_API_KEY" }

その他の MCP クライアント

設定	値
トランスポート	Streamable HTTP
URL	https://mcp.directiq.com/mcp
ヘッダー	x-api-key: <your DirectIQ API key>

ツール

ツール	機能	注釈
directiq_account_overview	アカウントの概要をまとめます：連絡先の合計数、有効／無効の件数、リスト数、タグ数、確認済み送信者アドレス	読み取り専用
directiq_contact_count	連絡先の合計数を返します	読み取り専用
directiq_list_contacts	連絡先をページ分割して一覧表示します（page、pageSize は最大 500）	読み取り専用
directiq_get_contact	数値 ID で単一の連絡先を取得します	読み取り専用
directiq_update_contact	連絡先のフィールド（例：firstName、lastName、email）を更新します	破壊的、冪等
directiq_list_lists	すべての連絡先リストを一覧表示します	読み取り専用
directiq_get_list	数値 ID で連絡先リストを取得します	読み取り専用
directiq_create_list	新しい連絡先リストを作成します	書き込み
directiq_list_tags	すべてのタグを一覧表示します	読み取り専用
directiq_get_tag	数値 ID でタグを取得します	読み取り専用
directiq_create_tag	新しいタグを作成します	書き込み
directiq_send_email	1 通のトランザクションメールを送信します（確認済み送信者から送信。宛先、件名、HTML またはテキストの内容、cc/bcc を指定）	書き込み、オープンワールド
directiq_list_endpoints	DirectIQ API の既知の操作を、任意の検索条件で一覧表示します	読み取り専用
directiq_read_request	DirectIQ API の任意のエンドポイントに対して、認証済み GET リクエストを実行します	読み取り専用
directiq_write_request	DirectIQ API の任意のエンドポイントに対して、認証済み POST/PUT/PATCH/DELETE リクエストを実行します。データを変更または完全に削除する場合があります	破壊的

各ツールは MCP アノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）を宣言するため、クライアントは変更の前に確認を求めることができます。API スキーマの全文：https://rest.directiq.com/{core|contacts|subscription}/swagger/index.html。

ドキュメント

• クライアントのセットアップ
• ツールリファレンス：各ツールの入力とアノテーション
• 認証とセキュリティ
• トラブルシューティング
• AI インストーラー向けの手順（Cline）

プロンプトの例

• 「DirectIQ アカウントの概要を教えてください。連絡先、リスト、タグ、確認済み送信者について知りたいです。」
• 「連絡先は何件ありますか？また、無効な連絡先は何件ですか？」
• 「『Fall Promo 2026』というリストと、『vip』というタグを作成してください。」
• 「連絡先 12345 を表示して、名を Jamie に変更してください。」
• 「件名を『Order confirmed』として、[email protected] から [email protected] に、お礼の短いメッセージを添えたトランザクションメールを送信してください。」
• 「サブスクリプションで利用できる DirectIQ API エンドポイントを教えてください。」

セキュリティとデータの取り扱い

• API キーは HTTPS 経由で mcp.directiq.com に送信され、x-api-key ヘッダーにのみ含まれます。チャットに貼り付けたり、リポジトリにコミットしたりしないでください。
• サーバーは、API キーに紐づく DirectIQ アカウントの権限で動作します。キーはいつでも Settings → API Keys で取り消すか、ローテーションできます。
• メールを送信できるのは、アカウントで確認済みの送信者アドレスからのみです。
• directiq_write_request と directiq_update_contact はデータを変更または削除できます。クライアントのツール承認プロンプトを有効にしておいてください。
• プライバシーポリシー：https://www.directiq.com/privacy-policy · 利用規約：https://www.directiq.com/terms-of-service

料金

MCP サーバーは無料で利用できます。このサーバー経由で送信したメールは、従量課金を含む通常の DirectIQ プランの利用分に算入されます。directiq.com/pricing をご覧ください。

サポート

• ヘルプセンター：https://help.directiq.com
• メール：[email protected]
• セットアップガイド：https://www.directiq.com/mcp-setup/
• このリポジトリまたは掲載内容に関する問題：GitHub Issues

変更履歴

CHANGELOG.md をご覧ください。

ライセンス

このリポジトリ内のドキュメントと設定は、MIT License のもとでライセンスされています。DirectIQ サービス自体には、DirectIQ Terms of Service が適用されます。