iletiMerkezi MCP Server

Сервер Model Context Protocol для API SMS iletiMerkezi. Позволяет LLM-клиентам с поддержкой MCP (Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code+Cline, Claude Desktop и др.) отправлять SMS, запрашивать отчеты о доставке и управлять отправителями/черными списками с помощью вызовов инструментов.

iletiMerkezi — это турецкая платформа для массовой рассылки SMS / OTP / A2P, лицензированная BTK. Форматы инструментов (схемы ввода, описания, ссылки на документацию) основаны на каноническом манифесте 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, приложение Gemini, веб-коннекторы Claude)

Этим клиентам требуется удаленный MCP (HTTPS-эндпоинты), они не запускают локальные команды npx. На данный момент этот сервер поставляется только в режиме stdio (локально). Поддержка хостинга находится в планах развития.

Учетные данные

Оба значения можно найти в panel.iletimerkezi.com → Settings → Security → API Access. Скопируйте их как есть — не хешируйте их самостоятельно; панель выдает уже вычисленный хеш.

Вам также необходимо включить Allow API access в разделе Settings → Security → Access Permissions, иначе каждый вызов будет возвращать 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. Резервная копия при сборке (dist/manifest.fallback.json), поставляемая с пакетом npm — снимок манифеста на момент npm publish.

Это означает, что новые эндпоинты или изменения схемы, опубликованные в манифесте, распространяются на запущенные клиенты в течение 24 часов без необходимости выполнения npm update. В этом репозитории нет вручную написанных схем инструментов — документация API является единственным источником истины.

Вы можете переопределить URL манифеста с помощью ILETIMERKEZI_MANIFEST_URL для сред тестирования / предварительного просмотра.

Локальная разработка

npm install
npm run build
npm test

Протестируйте сервер с реальным API, используя учетные данные в вашей оболочке:

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

Это взаимодействие по протоколу MCP через stdio. Используйте клиент 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.