Servidor MCP de iletiMerkezi

Servidor del Protocolo de Contexto de Modelo (MCP) para la API de SMS de iletiMerkezi. Permite a los clientes LLM compatibles con MCP (Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code+Cline, Claude Desktop, …) enviar SMS, consultar informes de entrega y gestionar remitentes/listas negras mediante llamadas a herramientas.

iletiMerkezi es una plataforma turca de SMS masivos / OTP / A2P con licencia de la BTK. Las formas de las herramientas (esquemas de entrada, descripciones, enlaces a documentación) se derivan de un manifiesto de API canónico que se construye a partir de la documentación oficial de los endpoints, por lo que este servidor se mantiene sincronizado con la API en vivo por diseño.

Herramientas

Related MCP server: Promotexter MCP Server

Instalación

Cinco clientes comparten el mismo esquema JSON mcpServers; Claude Code y Codex CLI también exponen un comando CLI de una sola línea. Elija su cliente a continuación.

Cliente → archivo de configuración

Configuración JSON compartida (Claude Code, Cursor, Gemini CLI, VS Code+Cline, Claude Desktop)

Agregue este bloque al archivo de configuración correspondiente:

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

Cierre completamente y reinicie el cliente. Las 11 herramientas aparecerán bajo el servidor iletimerkezi.

Claude Code — comando único

Ámbito de usuario (disponible en todos los proyectos):

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

Cierre la sesión actual de Claude Code e inicie una nueva. Las herramientas aparecerán como mcp__iletimerkezi__*. Elimine con claude mcp remove iletimerkezi -s user.

Codex CLI — formato TOML

A través de la CLI:

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

O edite ~/.codex/config.toml directamente:

[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"

Verificación

En el primer uso, pruebe get_balance y get_sender: ambos son de solo lectura, ninguno consume créditos.

Clientes alojados (Apps de ChatGPT, App de Gemini, Conectores Web de Claude)

Estos clientes requieren MCP remoto (endpoints HTTPS) y no ejecutan comandos npx locales. Este servidor se distribuye solo en modo stdio (local) actualmente. El soporte para clientes alojados está en la hoja de ruta.

Credenciales

Ambos valores provienen de panel.iletimerkezi.com → Settings → Security → API Access. Cópielos tal cual; no los hashee usted mismo; el panel emite un hash precalculado.

También debe habilitar Allow API access en Settings → Security → Access Permissions, de lo contrario, cada llamada devolverá 401. Este es el obstáculo de incorporación más común; el mensaje de error 401 del servidor apunta a este interruptor.

Para ver el contrato de autenticación completo, consulte https://www.iletimerkezi.com/docs/api/authentication.

Cómo se mantienen actualizadas las formas de las herramientas

Al arrancar, el servidor intenta, en orden:

1. Caché local en ~/.cache/iletimerkezi-mcp/manifest.json, válida por 24 horas.

2. Obtención en vivo de https://www.iletimerkezi.com/api/manifest.json (tiempo de espera de 5s). Si tiene éxito, actualiza la caché de forma atómica.

3. Respaldo en tiempo de compilación (dist/manifest.fallback.json) enviado con el paquete npm: la instantánea del manifiesto en el momento de npm publish.

Esto significa que los nuevos endpoints o cambios de esquema publicados en el manifiesto se propagan a los clientes en ejecución en un plazo de 24 horas, sin necesidad de npm update. No hay ningún esquema de herramienta escrito manualmente en ninguna parte de este repositorio: la documentación de la API es la única fuente de verdad.

Puede anular la URL del manifiesto con ILETIMERKEZI_MANIFEST_URL para entornos de prueba / previsualización.

Desarrollo local

npm install
npm run build
npm test

Realice una prueba de humo del servidor contra la API en vivo con las credenciales en su shell:

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

Esto habla MCP a través de stdio. Utilice un cliente MCP para interactuar, o canalice un handshake JSON-RPC manualmente para depurar.

Referencia

• Guía de configuración de MCP: https://www.iletimerkezi.com/docs/mcp (TR) · /en/docs/mcp (EN)

• Descripción general: https://www.iletimerkezi.com/docs/api/overview

• Autenticación: https://www.iletimerkezi.com/docs/api/authentication

• Códigos de error: https://www.iletimerkezi.com/docs/api/error-codes

• Manifiesto (legible por máquina): https://www.iletimerkezi.com/api/manifest.json

• Notas de la versión: CHANGELOG.md

Licencia

MIT — consulte LICENSE.