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 服务 mcp.directiq.com 的公开文档、注册表元数据和客户端配置，该服务由 DirectIQ 运营。无需安装或构建任何内容。

快速开始

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	发送一封事务性邮件（使用已确认的发件人；包含收件人、主题、HTML 或文本内容、抄送/密送）	写入，开放世界
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。”
• “从 [email protected] 向 [email protected] 发送一封事务性邮件，主题为 ‘Order confirmed’，并附上一段简短的感谢信息。”
• “DirectIQ 有哪些可用于订阅的 API 端点？”

安全与数据处理

• 你的 API 密钥仅会通过 HTTPS，以 x-api-key 标头发送到 mcp.directiq.com。切勿将其粘贴到聊天中或提交到代码库。
• 服务会以 API 密钥所属 DirectIQ 账户的权限执行操作。你可以随时在 设置 → API 密钥 中撤销或轮换密钥。
• 只能使用账户中已确认的发件人地址发送邮件。
• 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 约束。