iletiMerkezi MCP 服务器

iletiMerkezi SMS API 的模型上下文协议 (MCP) 服务器。它允许支持 MCP 的 LLM 客户端（Claude Code、Cursor、Codex CLI、Gemini CLI、VS Code+Cline、Claude Desktop 等）通过工具调用发送短信、查询发送报告以及管理发件人/黑名单。

iletiMerkezi 是一家土耳其的、拥有 BTK 许可的群发短信 / OTP / A2P 平台。工具形态（输入模式、描述、文档链接）源自官方端点文档构建的规范 API 清单，因此该服务器在设计上与实时 API 保持同步。

工具

Related MCP server: Promotexter MCP Server

安装

五个客户端共享相同的 JSON mcpServers 模式；Claude Code 和 Codex CLI 还提供了一行 CLI 命令。请在下方选择您的客户端。

客户端 → 配置文件

共享 JSON 配置（Claude Code、Cursor、Gemini CLI、VS Code+Cline、Claude Desktop）

将此块添加到相关的配置文件中：

{
  "mcpServers": {
    "iletimerkezi": {
      "command": "npx",
      "args": ["-y", "@iletimerkezi/mcp-server"],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}

完全退出并重新启动客户端。11 个工具将出现在 iletimerkezi 服务器下。

Claude Code — 单条命令

用户范围（适用于所有项目）：

claude mcp add iletimerkezi -s user \
  -e ILETIMERKEZI_API_KEY=your-api-key \
  -e ILETIMERKEZI_API_HASH=your-api-hash \
  -- npx -y @iletimerkezi/mcp-server

关闭当前的 Claude Code 会话并启动一个新会话。工具将显示为 mcp__iletimerkezi__*。使用 claude mcp remove iletimerkezi -s user 移除。

Codex CLI — TOML 格式

通过 CLI：

codex mcp add iletimerkezi \
  --env ILETIMERKEZI_API_KEY=your-api-key \
  --env ILETIMERKEZI_API_HASH=your-api-hash \
  -- npx -y @iletimerkezi/mcp-server

或者直接编辑 ~/.codex/config.toml：

[mcp_servers.iletimerkezi]
command = "npx"
args = ["-y", "@iletimerkezi/mcp-server"]

[mcp_servers.iletimerkezi.env]
ILETIMERKEZI_API_KEY = "your-api-key"
ILETIMERKEZI_API_HASH = "your-api-hash"

验证

首次使用时，请尝试 get_balance 和 get_sender — 两者均为只读，不会消耗额度。

托管客户端（ChatGPT Apps、Gemini App、Claude Web Connectors）

这些客户端需要 远程 MCP (HTTPS 端点)，且不会生成本地 npx 命令。目前此服务器仅以 stdio（本地）模式发布。托管支持已在路线图中。

凭据

这两个值均来自 panel.iletimerkezi.com → Settings → Security → API Access。请按原样复制它们 — 不要自行进行哈希处理；面板会提供预计算好的哈希值。

您还需要在 Settings → Security → Access Permissions 下启用 Allow API access，否则每次调用都会返回 401。这是最常见的入门陷阱；服务器的 401 错误消息会指向此开关。

有关完整的身份验证协议，请参阅 https://www.iletimerkezi.com/docs/api/authentication。

工具形态如何保持最新

启动时，服务器会按顺序尝试：

1. 本地缓存：位于 ~/.cache/iletimerkezi-mcp/manifest.json，有效期为 24 小时。

2. 实时获取：https://www.iletimerkezi.com/api/manifest.json（5 秒超时）。成功后，原子化刷新缓存。

3. 构建时回退：随 npm 包发布的 (dist/manifest.fallback.json) — 即 npm publish 时刻的清单快照。

这意味着发布到清单的新端点或模式更改会在 24 小时内传播到正在运行的客户端，无需 npm update。此仓库中没有任何 手动编写的工具模式 — API 文档是唯一的真理来源。

您可以使用 ILETIMERKEZI_MANIFEST_URL 覆盖清单 URL，用于暂存/预览环境。

本地开发

npm install
npm run build
npm test

使用 shell 中的凭据针对实时 API 对服务器进行冒烟测试：

ILETIMERKEZI_API_KEY=... ILETIMERKEZI_API_HASH=... node dist/index.js

这通过 stdio 进行 MCP 通信。使用 MCP 客户端进行交互，或手动通过管道传输 JSON-RPC 握手以进行调试。

参考

• MCP 设置指南：https://www.iletimerkezi.com/docs/mcp (TR) · /en/docs/mcp (EN)

• 概述：https://www.iletimerkezi.com/docs/api/overview

• 身份验证：https://www.iletimerkezi.com/docs/api/authentication

• 错误代码：https://www.iletimerkezi.com/docs/api/error-codes

• 清单（机器可读）：https://www.iletimerkezi.com/api/manifest.json

• 发行说明：CHANGELOG.md

许可证

MIT — 参见 LICENSE。