Sinch MCP Server
OfficialSinch MCP 서버 — 개발자 프리뷰
이 저장소에는 Sinch API와 상호 작용하기 위한 도구 세트를 제공하는 Sinch MCP 서버의 소스 코드가 포함되어 있습니다. 이 README는 Claude Desktop 클라이언트와 함께 MCP 서버를 사용하는 데 중점을 두지만, 다른 모든 MCP 클라이언트와 함께 사용할 수도 있습니다.
도구 개요
MCP 서버에서 사용할 수 있는 도구 목록입니다(모든 전화번호는 E.164 형식으로 제공되어야 합니다. 예: 프랑스의 경우 +33612345678).
대화 도구
도구 | 설명 | 태그 |
send-text-message | 지원되는 채널의 수신자에게 일반 텍스트 메시지를 보냅니다. 예시 프롬프트: "SMS를 통해 전화번호 +33612345678로 간단한 업데이트를 보내줘." | conversation, notification |
send-media-message | 미디어 메시지를 통해 이미지, 비디오 또는 문서를 보냅니다. 예시 프롬프트: "WhatsApp을 통해 전화번호 +33612345678로 제품 브로셔 PDF를 보내줘." | conversation, notification |
send-template-message | 미리 정의된 템플릿(omni-template만 해당)을 사용하여 메시지를 보냅니다. 예시 프롬프트: "Messenger에서 이 사용자에게 스페인어로 된 약속 알림 템플릿을 보내줘." | conversation, notification |
send-whatsapp-template-message | 미리 정의된 WhatsApp 템플릿을 사용하여 메시지를 보냅니다. 예시 프롬프트: "WhatsApp에서 "appointment-reminder" 템플릿을 사용하여 메시지를 보내줘." | conversation, notification |
send-choice-message | 대화형 선택 항목(버튼 또는 빠른 답장)이 포함된 메시지를 보냅니다. 예시 프롬프트: "+33612345678로 선호하는 아이스크림 맛에 대한 RCS 설문조사를 다음 선택 항목과 함께 보내줘: 바닐라, 딸기, 헤이즐넛". | conversation, notification |
send-location-message | 사용자에게 위치 핀이나 좌표를 보냅니다. 예시 프롬프트: "빌바오의 구겐하임 미술관 위치 핀을 전화번호 +33612345678로 보내줘." | conversation, notification |
list-conversation-apps | Sinch 계정에 구성된 모든 대화 앱을 나열합니다. 예시 프롬프트: "내 계정에 설정된 메시징 앱은 무엇인가요?" | conversation, notification |
list-messaging-templates | 모든 옴니채널 및 채널별 메시지 템플릿을 나열합니다. 예시 프롬프트: "내 계정의 모든 메시지 템플릿을 보여줘." | conversation, notification |
이메일 도구 (Mailgun)
도구 | 설명 | 태그 |
send-email | 미리 정의된 HTML 템플릿 또는 원시 HTML/텍스트 콘텐츠를 사용하여 이메일을 보냅니다. 예시 프롬프트: "온보딩 템플릿을 사용하여 john@example.com으로 환영 이메일을 보내줘." | email, notification |
list-email-templates | 특정 도메인에서 사용할 수 있는 모든 이메일 템플릿을 나열합니다. 예시 프롬프트: "사용 가능한 이메일 템플릿이 무엇인가요?" | email, notification |
retrieve-email-info | 특정 이메일 메시지에 대한 메타데이터, 콘텐츠 및 배달 상태를 검색합니다. 예시 프롬프트: "ID가 인 이메일의 배달 상태를 가져올 수 있나요?" | email, notification |
list-email-events | 반송, 열람 또는 클릭과 같은 최근 이메일 배달 이벤트를 검색하고 그룹화합니다. 예시 프롬프트: "내 계정의 최근 이메일 활동을 모두 보여줘." | |
analytics-metrics | 열람률 또는 클릭률과 같은 이메일 분석 지표를 검색합니다. 예시 프롬프트: "지난주 열람률은 어떻게 되나요?" |
인증 도구
도구 | 설명 | 태그 |
number-lookup | 전화번호의 상태와 기능을 조회합니다. 예시 프롬프트: "다음 전화번호의 기능을 조회해줘: +33501020304." | verification |
start-sms-verification | 사용자의 전화번호로 OTP를 보내 SMS 인증을 시작합니다. 예시 프롬프트: "+33612345678 번호로 전화 인증을 시작해줘." | verification |
report-sms-verification | 일회용 비밀번호(OTP)를 제출하여 SMS 인증을 완료합니다. 예시 프롬프트: "이 코드로 전화번호를 인증해줘: 1234." | verification |
음성 도구
도구 | 설명 | 태그 |
tts-callout | 음성 통화를 걸고 텍스트 음성 변환(TTS)을 사용하여 메시지를 소리 내어 읽어줍니다. 예시 프롬프트: "전화번호 +33612345678로 전화를 걸어 '내일 오전 10시에 약속이 있습니다'라고 말해줘." | voice, notification |
conference-callout | 하나 이상의 참가자에게 음성 통화를 시작하고 공유 회의에 연결합니다. 예시 프롬프트: "John(+33612345678)과 Lisa(+34987654321)에게 전화를 걸어 회의실에 연결해줘." | voice |
manage-conference-participant | 회의 통화 중 개별 참가자를 음소거, 음소거 해제, 대기 또는 재개합니다. 예시 프롬프트: "회의에서 ID가 xyz789인 발신자를 음소거해줘." | voice |
close-conference | 회의 ID를 사용하여 모든 참가자의 연결을 끊어 회의 통화를 종료합니다. 예시 프롬프트: "ID가 abc123인 현재 회의 통화를 종료해줘." | voice |
번호 도구
도구 | 설명 | 태그 |
list-available-regions | 프로젝트에 사용할 수 있는 전화번호가 있는 모든 지역을 나열합니다. 번호 유형(MOBILE, LOCAL, TOLL_FREE)별로 필터링할 수 있습니다. 예시 프롬프트: "수신자 부담 번호를 사용할 수 있는 지역은 어디인가요?" | numbers |
list-rented-numbers | 프로젝트에 대해 활성화된(임대된) 모든 전화번호를 나열합니다. 지역, 유형, 패턴 및 기능별로 필터링할 수 있습니다. 예시 프롬프트: "미국에서 활성화된 내 전화번호를 모두 보여줘." | numbers |
search-for-available-numbers | 지역, 유형, 패턴 및 기능에 대한 필터를 사용하여 임대 가능한 전화번호를 검색합니다. 예시 프롬프트: "SMS를 지원하는 미국 내 사용 가능한 지역 번호를 찾아줘." | numbers |
rent-sinch-virtual-numbers | E.164 형식으로 제공하여 하나 이상의 전화번호를 임대(활성화)합니다. 예시 프롬프트: "전화번호 +12025551234를 임대해줘." | numbers |
구성 도구
도구 | 설명 | 태그 |
sinch-mcp-configuration | Sinch MCP 서버에서 사용할 수 있는 모든 도구와 해당 상태를 나열합니다. 도구가 비활성화된 경우 그 이유가 표시됩니다. 예시 프롬프트: "Sinch MCP 서버에서 사용할 수 있는 도구는 무엇인가요?" |
Related MCP server: Twilio MCP Server
시작하기
사전 요구 사항
프로비저닝된 Sinch Build 계정
Claude Desktop (또는 기타 MCP 클라이언트). 이 README는 Claude Desktop에 중점을 두지만, MCP 서버는 모든 MCP 클라이언트와 함께 사용할 수 있습니다.
API 자격 증명
MCP 도구에서 사용하는 API를 사용하려면 다음 자격 증명이 필요합니다:
Conversation / Numbers API 자격 증명:
(필수)
PROJECT_ID: Sinch Build 대시보드에서 사용할 프로젝트를 선택합니다(상단 툴바 왼쪽).
(필수)
KEY_ID: Sinch Build 대시보드의 액세스 키 섹션에서 새 액세스 키를 선택하거나 생성합니다.(필수)
KEY_SECRET: 이전 단계에서 선택하거나 생성한Access Key와 관련된 비밀 키입니다. 주의:Access Key Secret은Access Key를 생성할 때 한 번만 표시됩니다. 분실 시 새Access Key를 생성해야 합니다.CONVERSATION_APP_ID: 사용할 대화 앱의 ID입니다. Sinch Build 대시보드의 대화 API / 앱 섹션에서 찾을 수 있습니다. 설정하지 않으면 프롬프트에서 지정해야 합니다.CONVERSATION_REGION: 대화 앱과 템플릿이 위치한 지역입니다.us,eu또는br일 수 있습니다. 설정하지 않으면 기본값은us입니다.SMS 채널을 사용할 때
DEFAULT_SMS_ORIGINATOR환경 변수를 SMS 메시지의 발신자로 사용할 전화번호로 설정할 수도 있습니다. 국가에 따라 이 설정이 필요할 수 있습니다.위치 기능을 사용하려면
GEOCODING_API_KEY환경 변수를 Google Geocoding API 키로 설정할 수도 있습니다. 주소를 위도/경도 쌍으로 변환하는 데 필요합니다.
Verification API 자격 증명: Sinch Build 대시보드의 인증 / 앱 섹션으로 이동하여 새 앱을 만들거나 기존 앱을 선택합니다. 다음 자격 증명이 필요합니다:
(필수)
APPLICATION_KEY(필수)
APPLICATION_SECRET
Voice API 자격 증명: Sinch Build 대시보드의 음성 / 앱 섹션으로 이동하여 새 앱을 만들거나 기존 앱을 선택합니다. 다음 자격 증명이 필요합니다:
(필수)
APPLICATION_KEY(필수)
APPLICATION_SECRETCALLING_LINE_IDENTIFICATION환경 변수를 사용자가 전화를 받을 때 표시될 전화번호로 설정할 수도 있습니다.
Mailgun API 자격 증명: Mailgun 대시보드의 Mailgun / 도메인 섹션으로 이동하여 새 도메인을 만들거나 기존 도메인을 선택합니다. 다음 자격 증명이 필요합니다:
(필수)
MAILGUN_API_KEYMAILGUN_DOMAINMAILGUN_SENDER_ADDRESS
MCP 서버 구성
Sinch MCP 서버는 실행 가능한 NPM 패키지로 제공됩니다. Claude Desktop 구성 파일(claude_desktop_config.json)에서 설정하는 방법은 다음과 같습니다. 환경 변수에 자신의 자격 증명을 입력하는 것을 잊지 마십시오:
{
"mcpServers": {
"sinch": {
"command": "npx",
"args": [
"-y",
"@sinch/mcp"
],
"env": {
"PROJECT_ID": "",
"KEY_ID": "",
"KEY_SECRET": "",
"CONVERSATION_APP_ID": "",
"CONVERSATION_REGION": "",
"DEFAULT_SMS_ORIGINATOR": "",
"GEOCODING_API_KEY": "",
"APPLICATION_KEY": "",
"APPLICATION_SECRET": "",
"CALLING_LINE_IDENTIFICATION": "",
"MAILGUN_API_KEY": "",
"MAILGUN_DOMAIN": "",
"MAILGUN_SENDER_ADDRESS": ""
}
}
}
}로컬에서 MCP 서버 실행
옵션 1: Claude Desktop을 사용하여 stdio로 MCP 서버 시작
Claude Desktop에서 로컬로 MCP 서버를 실행하려면 저장소를 복제하고 MCP 서버를 빌드해야 합니다. 이 옵션은 로컬 개발 및 테스트에 유용합니다.
1단계: 저장소 복제
git clone https://github.com/sinch/sinch-mcp-server.git2단계: MCP 서버 빌드
cd sinch-mcp-server
npm install
npm run build3단계: Claude Desktop 구성 설정
Claude Desktop 구성 파일(claude_desktop_config.json)에서 MCP 서버를 구성하는 방법의 예입니다:
{
"mcpServers": {
"sinch": {
"command": "node",
"args": [
"/your/path/to/sinch-mcp-server/dist/index.js"
],
"env": {
"PROJECT_ID": "",
"KEY_ID": "",
"KEY_SECRET": "",
"CONVERSATION_APP_ID": "",
"CONVERSATION_REGION": "",
"DEFAULT_SMS_ORIGINATOR": "",
"GEOCODING_API_KEY": "",
"APPLICATION_KEY": "",
"APPLICATION_SECRET": "",
"CALLING_LINE_IDENTIFICATION": "",
"MAILGUN_API_KEY": "",
"MAILGUN_DOMAIN": "",
"MAILGUN_SENDER_ADDRESS": ""
}
}
}
}4단계: (선택 사항) MCP 서버에서 사용 가능한 도구 필터링
도구가 너무 많으면 컨텍스트가 커지고 토큰 사용량이 증가하며 LLM이 올바른 도구를 선택하는 데 혼란을 줄 수 있습니다.
tags 옵션을 사용하여 MCP 서버에서 사용 가능한 도구를 필터링할 수 있습니다. 예를 들어 대화 도구만 사용하려면 args 배열에 다음 옵션을 추가할 수 있습니다:
"args": [
"/your/path/to/sinch-mcp-server/dist/index.js",
"--tags",
"conversation"
],쉼표로 구분하여 여러 태그를 결합할 수 있습니다. 예를 들어 대화 도구와 인증 도구를 모두 사용하려면 다음 명령을 사용할 수 있습니다:
"args": [
"/your/path/to/sinch-mcp-server/dist/index.js",
"--tags",
"conversation,verification"
],모든 도구를 사용하려면 --tags 옵션을 생략하거나 all 태그를 사용할 수 있습니다:
"args": [
"/your/path/to/sinch-mcp-server/dist/index.js",
"--tags",
"all"
],옵션 2: 원격으로 MCP 서버를 시작하고 SSE를 사용하여 연결
이 옵션을 사용하면 원격 컴퓨터에서 MCP 서버를 실행하고 SSE(Server-Sent Events)를 사용하여 연결할 수 있습니다. 클라우드 서버나 전용 컴퓨터에서 MCP 서버를 실행하려는 경우 유용합니다. 기본적으로 Claude Desktop은 STDIO를 사용하여 MCP 서버에 연결합니다. SSE를 사용하여 MCP 서버에 연결하기 위해 supergateway 라이브러리를 사용합니다.
1단계: MCP 서버 빌드
cd sinch-mcp-server
npm install
npm run build2단계: MCP 서버 구성 설정
.template.env 파일을 복사하고 이름을 .env로 바꿉니다. 그런 다음 자리 표시자를 자신의 자격 증명으로 바꾸고 필요 없는 키는 삭제합니다. .env 파일은 다음과 같아야 합니다():
# Conversation / Numbers tools related environment variables
PROJECT_ID=
KEY_ID=
KEY_SECRET=
## Optional but recommended: the App ID holding your channels integration configuration. If not set it must be present in the prompt
CONVERSATION_APP_ID=
## Optional, defaults to "us". Other possible values are "eu" and "br"
CONVERSATION_REGION=
## Needed only if you want to send SMS messages: it is the number that will be used as the sender for SMS messages
DEFAULT_SMS_ORIGINATOR=
## Needed only if you want to send location messages: it converts an address to a latitude/longitude pair
GEOCODING_API_KEY=
# Verification / Voice tools related environment variables
APPLICATION_KEY=
APPLICATION_SECRET=
## Needed only if you want to make calls: it is the number that will be displayed to the user when they receive a call
CALLING_LINE_IDENTIFICATION=
# Mailgun tools related environment variables
MAILGUN_DOMAIN=
MAILGUN_API_KEY=
MAILGUN_SENDER_ADDRESS=3단계: MCP 서버 시작
npm run start:stdio기본적으로 이 명령은 모든 도구를 사용할 수 있는 상태로 MCP를 시작합니다. MCP 서버에서 사용 가능한 도구를 필터링하려면 --tags 옵션을 사용할 수 있습니다. 예를 들어 대화 도구만 사용하려면 명령을 다음과 같이 수정할 수 있습니다:
# Original command
"start:sse": "tsc --project tsconfig.build.json && (npx -y supergateway --stdio \"node dist/index.js\" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message)"
# Modified command to only use conversation tools
"start:sse": "tsc --project tsconfig.build.json && (npx -y supergateway --stdio \"node dist/index.js --tag conversation\" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message)"쉼표로 구분하여 여러 태그를 결합할 수 있습니다. 예를 들어 대화 도구와 인증 도구를 모두 사용하려면 다음 명령을 사용할 수 있습니다:
"start": "tsc --project tsconfig.build.json && (npx -y supergateway --stdio \"node dist/index.js --tag conversation,verification\" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message)"Available Tools
1 toolsinch-mcp-configurationA
This tool allows you to retrieve the configuration of the Sinch MCP server. It provides information about which tools are enabled and disabled with some troubleshooting information about why a tool would be disabled.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses that the tool retrieves configuration and troubleshooting data, implying it's a read-only operation without side effects. However, it doesn't specify behavioral traits like rate limits, authentication needs, or response format, leaving gaps in transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and front-loaded, stating the main purpose in the first sentence and adding useful details in the second. Both sentences earn their place by clarifying the tool's function and output, with no wasted words or unnecessary elaboration.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (0 parameters, no annotations, no output schema), the description is adequate but has gaps. It explains what the tool does and the type of information returned, but without an output schema, it doesn't detail the structure or format of the configuration data, which could hinder agent understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters with 100% schema description coverage, so the schema fully documents the lack of inputs. The description doesn't need to add parameter details, and it appropriately focuses on the tool's purpose without redundant information, meeting the baseline for no parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'retrieve the configuration of the Sinch MCP server' with specific details about what information is provided ('which tools are enabled and disabled with some troubleshooting information'). It distinguishes itself by focusing on server configuration rather than performing operations, though there are no sibling tools for comparison.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage context by mentioning 'troubleshooting information about why a tool would be disabled,' suggesting it should be used for diagnostic purposes. However, it lacks explicit guidance on when to use this tool versus alternatives or any prerequisites, as there are no sibling tools to compare against.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
1 tool update
v1.0.0- First observed
sinch-mcp-configuration
TDQS
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool has a single, clear purpose described in its name and description.
The single tool name follows a consistent pattern of 'sinch-mcp-configuration', which is descriptive and aligns with the server's purpose. There are no other tools to compare against, so consistency is inherently perfect.
A single tool for a server named 'Sinch MCP Server' suggests a very limited scope. While it might be appropriate for a minimal configuration server, it feels thin and underdeveloped for a general-purpose server, indicating potential gaps in functionality.
The tool only provides configuration retrieval, which is a meta-operation about the server itself. There are no tools for actual Sinch-related operations (e.g., sending messages, managing contacts), making the surface severely incomplete for any practical use case beyond server introspection.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Send and schedule SMS and WhatsApp messages, manage contacts and templates, and track delivery.
Send and receive across email, SMS, WhatsApp, and voice. One API, one contract.
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Send, search, and manage notifications, accounts, and push preferences
Related MCP Servers
FlicenseBqualityFmaintenanceEnables interaction with Telnyx's telephony, messaging, and AI assistant APIs to manage phone numbers, send messages, make calls, and create AI assistants. Includes webhook support for real-time event handling and comprehensive tools for voice, SMS, cloud storage, and embeddings.4625-- AlicenseNot gradedqualityNot gradedmaintenanceEnables communication through Twilio's API including sending SMS/WhatsApp messages, making phone calls, and managing phone numbers and account settings. Provides comprehensive messaging and voice capabilities with proper authentication and rate limiting.-
- AlicenseNot gradedqualityDmaintenanceProvides a standardized interface for interacting with WhatsApp's tools and services through a unified API.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with WhatsApp Business tools and services through a unified API.2MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sinch/sinch-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server