iletiMerkezi MCP 서버

iletiMerkezi SMS API를 위한 Model Context Protocol 서버입니다. MCP를 지원하는 LLM 클라이언트(Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code+Cline, Claude Desktop 등)가 도구 호출을 통해 SMS를 발송하고, 발송 보고서를 조회하며, 발신자 및 블랙리스트를 관리할 수 있도록 합니다.

iletiMerkezi는 터키의 BTK 인증을 받은 대량 SMS / OTP / A2P 플랫폼입니다. 도구 형태(입력 스키마, 설명, 문서 링크)는 공식 엔드포인트 문서에서 생성된 표준 API 매니페스트에서 파생되므로, 이 서버는 설계상 라이브 API와 항상 동기화된 상태를 유지합니다.

도구

Related MCP server: Promotexter MCP Server

설치

5개의 클라이언트가 동일한 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에서 확인할 수 있습니다. 그대로 복사하세요. 직접 해시하지 마십시오. 패널에서 미리 계산된 해시를 제공합니다.

또한 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 시점의 매니페스트 스냅샷.

즉, 매니페스트에 게시된 새로운 엔드포인트나 스키마 변경 사항은 npm update 없이도 24시간 이내에 실행 중인 클라이언트에 전파됩니다. 이 저장소 어디에도 수동으로 작성된 도구 스키마는 없으며, API 문서가 유일한 진실의 원천입니다.

스테이징/미리보기 환경의 경우 ILETIMERKEZI_MANIFEST_URL을 사용하여 매니페스트 URL을 재정의할 수 있습니다.

로컬 개발

npm install
npm run build
npm test

셸에 자격 증명을 입력하여 라이브 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를 참조하세요.