1. 服务概述一句话简介:土耳其BTK许可的批量短信/OTP/A2P平台MCP服务器,支持短信发送、投递报告查询、发送者/黑名单管理服务名称:iletiMerkezi MCP Server版本号:Latest开发者/提供方:iletimerkezi协议类型:MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点:短信发送:向一个或多个号码发送短信投递报告:查询短信投递报告(摘要和每个收件人)账户余额:查询账户余额(TL和短信积分)发送者列表:获取已批准的发送者(头部)列表黑名单管理:查询、添加和删除黑名单号码自动更新:工具形状从API清单自动派生,保持与实时API同步3. 使用场景描述该服务适合在什么情况下使用:批量短信:营销活动、通知、提醒等批量短信发送OTP验证:一次性密码发送用于用户验证A2P通信:应用到个人的短信通信投递跟踪:跟踪短信投递状态和成功率黑名单管理:管理退订用户和黑名单号码4. 接入方式4.1 服务端点API基础URL:https://www.iletimerkezi.comAPI版本:v14.2 认证与权限API密钥:ILETIMERKEZI_API_KEY(从panel.iletimerkezi.com获取)API哈希:ILETIMERKEZI_API_HASH(面板提供的预计算哈希)权限设置:需要在Settings → Security → Access Permissions中启用Allow API access4.3 数据格式所有API端点使用JSON格式:请求:POST方法,JSON请求体响应:JSON格式,包含状态、数据和错误信息4.4 服务器配置Claude Desktop配置:{ mcpServers: { iletimerkezi: { command: npx, args: [-y, iletimerkezi/mcp-server], env: { ILETIMERKEZI_API_KEY: your-api-key, ILETIMERKEZI_API_HASH: your-api-hash } } } }5. 接口定义工具列表工具名称API端点描述send_smsPOST /v1/send-sms/json向一个或多个号码发送短信get_reportPOST /v1/get-report/json查询投递报告(摘要每个收件人)get_balancePOST /v1/get-balance/json查询账户余额(TL短信积分)get_senderPOST /v1/get-sender/json获取已批准的发送者列表get_blacklistPOST /v1/get-blacklist/json查询黑名单号码(分页)add_blacklistPOST /v1/add-blacklist/json添加号码到黑名单(幂等)delete_blacklistPOST /v1/delete-blacklist/json从黑名单移除号码工具形状自动更新服务器启动时按顺序尝试:本地缓存:~/.cache/iletimerkezi-mcp/manifest.json,有效期24小时实时获取:https://www.iletimerkezi.com/api/manifest.json(5秒超时)构建时回退:dist/manifest.fallback.json(npm包附带的快照)6. 快速开始6.1 环境要求Node.js和npm/npxiletiMerkezi账户和API密钥6.2 示例代码获取API密钥:访问panel.iletimerkezi.com进入Settings → Security → API Access复制API Key和API Hash在Settings → Security → Access Permissions中启用Allow API access本地开发测试:npm install npm run build npm test ILETIMERKEZI_API_KEY... ILETIMERKEZI_API_HASH... node dist/index.js7. 注意事项常见问题:401错误通常是因为未启用Allow API access权限API密钥格式:面板提供预计算哈希,无需自行哈希自动更新:新端点或架构变更在24小时内自动传播到运行中的客户端清单驱动:无手动编写的工具架构,API文档是唯一真相来源许可证:MIT许可证官方文档:https://www.iletimerkezi.com/docs/api/overview错误代码:https://www.iletimerkezi.com/docs/api/error-codes