Instagram MCP Server
Instagram MCP Server (또한 WhatsApp 및 Messenger)
MCP 서버로, Claude, Cursor, Claude Code 및 기타 모든 MCP 클라이언트가 공식 Meta Business API를 통해 Instagram DM, WhatsApp 메시지 및 Facebook Messenger 대화를 읽고 답장할 수 있게 해줍니다.
어시스턴트에게 *"Instagram에서 가격을 문의한 리드를 찾아 예약 템플릿을 보내줘"*라고 요청하면 실제 계정에서 그대로 실행됩니다.
왜 이것이 다른가
대부분의 Instagram 및 WhatsApp MCP 서버는 개인 계정을 사용합니다: 브라우저 자동화 세션, 비공식 브리지, 또는 리버스 엔지니어링된 모바일 API입니다. Meta가 무언가를 변경하면 작동이 중단되고, 계정이 비활성화될 위험에 처합니다.
이 서버는 SetSmart의 Meta 승인 비즈니스 앱을 통해 공식 Instagram Messaging API, WhatsApp Cloud API 및 Messenger Platform과 통신합니다. 승인된 앱 없이는 Instagram, WhatsApp 또는 Messenger에 프로그래밍 방식으로 메시지를 보낼 수 없기 때문에, 이 브리지는 Instagram 비밀번호 대신 SetSmart 워크스페이스가 필요합니다.
이것이 명확히 말한 트레이드오프입니다: 자신의 계정에 대해 자체 호스팅할 수 없으며, SetSmart API 키가 필요합니다.
Related MCP server: Meta MCP Server
요구 사항
Node.js 18 이상
SetSmart 워크스페이스에 최소 하나의 채널(Instagram, WhatsApp 또는 Messenger)이 연결되어 있어야 합니다.
설정(Settings)의 통합(Integrations)에서 워크스페이스 API 키를 가져옵니다.
빠른 시작
Claude Desktop / Claude Code
MCP 구성(claude_desktop_config.json 또는 Claude Code의 .mcp.json)에 다음을 추가하세요:
{
"mcpServers": {
"setsmart": {
"command": "npx",
"args": ["-y", "setsmart-mcp"],
"env": {
"SETSMART_API_KEY": "your-workspace-api-key"
}
}
}
}Cursor
동일한 블록을 ~/.cursor/mcp.json에 추가하세요.
원격 MCP, 이 브리지 없이
SetSmart MCP 서버는 OAuth를 통한 Streamable HTTP로 직접 접근할 수 있으므로, 원격 MCP를 지원하는 클라이언트는 이 패키지를 완전히 건너뛸 수 있습니다:
https://setsmart.io/api/mcp클라이언트가 stdio만 지원하거나, 대화형 OAuth 동의 대신 정적 API 키로 인증하고 싶다면 이 브리지를 사용하세요.
도구
30개의 도구가 있으며, 다루는 대상별로 그룹화되어 있습니다.
메시징
Tool | What it does |
| Instagram, WhatsApp 또는 Messenger에서 텍스트 메시지 보내기 |
| 이미지 보내기 |
| 동영상 보내기 |
| 음성 메시지 보내기 |
| 승인된 WhatsApp 템플릿 보내기 |
| 메시지에 반응하기 |
대화
Tool | What it does |
| 워크스페이스의 대화 목록 보기 |
| 이름, 번호 또는 내용으로 대화 검색 |
| 하나의 대화와 상태 읽기 |
| 메시지 기록 읽기 |
| 대화에 태그 추가 |
| 태그 제거 |
| 내부 메모 작성 |
연락처
Tool | What it does |
| 전화, 이메일, Instagram 사용자 이름 또는 태그로 연락처 찾기 |
| 하나의 연락처 읽기 |
| 연락처 생성 |
| 태그 추가 |
| 태그 제거 |
AI 제어
Tool | What it does |
| AI 어시스턴트가 활성화된 위치 확인 |
| 인간 핸드오버를 위해 한 대화에서 어시스턴트 중지 |
| 어시스턴트에게 다시 넘기기 |
| 전체 채널 일시 중지 |
| 채널 재개 |
Tool | What it does |
| 계정의 게시물 목록 보기 |
| 게시물의 댓글 트리거 읽기 |
| 자동 댓글 답변 설정 읽기 |
예약, 템플릿 및 통계
Tool | What it does |
| 예약되었지만 전송되지 않은 메시지 목록 보기 |
| 예약된 메시지 취소 |
| 메시지 템플릿 목록 보기 |
| 대화 및 답변 통계 읽기 |
의도적으로 할 수 없는 것
API 키는 장기간 유지되는 정적 비밀이므로 제한된 표면을 갖습니다. 다음은 원격 서버의 대화형 OAuth를 통해서만 접근할 수 있으며, 이 브리지를 통해서는 절대 접근할 수 없습니다:
결제 및 구독 변경
워크스페이스 설정
채널 연결 또는 연결 해제
AI 어시스턴트 생성 또는 재작성
대량 삭제, 블랙리스트, 차단된 국가
SetSmart 설정에서 키를 교체하면 다음 요청 시 즉시 접근이 취소됩니다.
구성
Variable | Default | Purpose |
| required | 워크스페이스 API 키 |
|
| 업스트림 엔드포인트 재정의 |
작동 방식
이 패키지에는 메시징 로직이 포함되어 있지 않습니다. stdio에서 Streamable HTTP로의 파이프입니다: 클라이언트는 stdin과 stdout을 통해 MCP를 사용하고, 브리지는 각 요청을 Authorization 헤더에 키를 넣어 호스팅된 SetSmart MCP 서버로 전달하고 응답을 다시 스트리밍합니다. 약 150줄이며, src/index.js에 있으므로 계정을 신뢰하기 전에 전체를 읽을 수 있습니다.
링크
라이선스
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage Instagram and Facebook automations, conversations, templates, and analytics with AI.
Instagram + Facebook Pages: read comments, reply, DM commenters, comment-to-DM Auto DM rules.
- RickyOAuthai.getricky
Customer inbox and CRM for WhatsApp, Instagram and Messenger: contacts, conversations, reports.
Read and search your Instagram, WhatsApp and LinkedIn DMs and prepare follow-ups you approve.
Related MCP Servers
- FlicenseBqualityNot gradedmaintenanceEnables AI assistants to interact with Instagram and Facebook accounts through their APIs, supporting messaging, post management, commenting, and content creation.14-
- AlicenseBqualityCmaintenanceConnects AI assistants to Meta's business platforms (Facebook, Instagram, Threads, Ads, Commerce) with 200 tools for publishing, engagement, analytics, ads, and commerce management.100140 npm60MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Meta's messaging APIs (WhatsApp, Messenger, Instagram) for sending messages, managing templates, and handling webhooks via natural language.4 npmGPL 3.0
- AlicenseAqualityCmaintenanceEnables direct management of Facebook Pages and linked Instagram Business/Creator accounts through the official Meta Graph API, including posting, scheduling, reading and responding to comments, and viewing insights.20MIT