Skip to main content
Glama

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

message_send_text

Instagram, WhatsApp 또는 Messenger에서 텍스트 메시지 보내기

message_send_image

이미지 보내기

message_send_video

동영상 보내기

message_send_audio

음성 메시지 보내기

message_send_template

승인된 WhatsApp 템플릿 보내기

message_send_reaction

메시지에 반응하기

대화

Tool

What it does

conversation_list

워크스페이스의 대화 목록 보기

conversation_search

이름, 번호 또는 내용으로 대화 검색

conversation_get

하나의 대화와 상태 읽기

conversation_get_messages

메시지 기록 읽기

conversation_add_tag

대화에 태그 추가

conversation_remove_tag

태그 제거

conversation_set_notes

내부 메모 작성

연락처

Tool

What it does

contact_find

전화, 이메일, Instagram 사용자 이름 또는 태그로 연락처 찾기

contact_get

하나의 연락처 읽기

contact_import

연락처 생성

contact_add_tags

태그 추가

contact_remove_tags

태그 제거

AI 제어

Tool

What it does

ai_get_all_status

AI 어시스턴트가 활성화된 위치 확인

ai_pause_conversation

인간 핸드오버를 위해 한 대화에서 어시스턴트 중지

ai_resume_conversation

어시스턴트에게 다시 넘기기

ai_pause_channel

전체 채널 일시 중지

ai_resume_channel

채널 재개

Instagram

Tool

What it does

instagram_post_list

계정의 게시물 목록 보기

instagram_post_get_triggers

게시물의 댓글 트리거 읽기

comment_reply_get_auto_reply

자동 댓글 답변 설정 읽기

예약, 템플릿 및 통계

Tool

What it does

scheduled_list

예약되었지만 전송되지 않은 메시지 목록 보기

scheduled_cancel

예약된 메시지 취소

template_list

메시지 템플릿 목록 보기

analytics_stats

대화 및 답변 통계 읽기

의도적으로 할 수 없는 것

API 키는 장기간 유지되는 정적 비밀이므로 제한된 표면을 갖습니다. 다음은 원격 서버의 대화형 OAuth를 통해서만 접근할 수 있으며, 이 브리지를 통해서는 절대 접근할 수 없습니다:

  • 결제 및 구독 변경

  • 워크스페이스 설정

  • 채널 연결 또는 연결 해제

  • AI 어시스턴트 생성 또는 재작성

  • 대량 삭제, 블랙리스트, 차단된 국가

SetSmart 설정에서 키를 교체하면 다음 요청 시 즉시 접근이 취소됩니다.

구성

Variable

Default

Purpose

SETSMART_API_KEY

required

워크스페이스 API 키

SETSMART_MCP_URL

https://setsmart.io/api/mcp

업스트림 엔드포인트 재정의

작동 방식

이 패키지에는 메시징 로직이 포함되어 있지 않습니다. stdio에서 Streamable HTTP로의 파이프입니다: 클라이언트는 stdin과 stdout을 통해 MCP를 사용하고, 브리지는 각 요청을 Authorization 헤더에 키를 넣어 호스팅된 SetSmart MCP 서버로 전달하고 응답을 다시 스트리밍합니다. 약 150줄이며, src/index.js에 있으므로 계정을 신뢰하기 전에 전체를 읽을 수 있습니다.

링크

라이선스

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Connects AI assistants to Meta's business platforms (Facebook, Instagram, Threads, Ads, Commerce) with 200 tools for publishing, engagement, analytics, ads, and commerce management.
    100
    140 npm
    60
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with Meta's messaging APIs (WhatsApp, Messenger, Instagram) for sending messages, managing templates, and handling webhooks via natural language.
    4 npm
    GPL 3.0
  • A
    license
    A
    quality
    C
    maintenance
    Enables 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.
    20
    MIT