MCP 서버

Instagram MCP 서버 모든 AI 에이전트가 Instagram에 게시하게 하세요

AI 에이전트가 프롬프트 하나로 Instagram에 릴스, 사진, 캐러셀, 스토리를 게시하고, 댓글에 답글을 달고, DM을 보내고, 댓글-DM 자동화를 운영하게 하세요.

mcp.json
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

에이전트가 호출할 수 있는 Instagram 도구

Upload-Post MCP 서버의 일부입니다. 에이전트가 프롬프트에 맞는 도구를 골라 씁니다.

도구 기능
upload_video 캡션, 커버, 공동 작업자, 예약 옵션과 함께 릴스 또는 동영상 스토리 게시
upload_photos 사진, 최대 10개 항목의 캐러셀 또는 사진 스토리 게시
get_post_comments / reply_to_comment / public_reply_to_comment 댓글 읽기 및 공개·비공개 답글
send_dm / list_dm_conversations DM 보내기 및 확인
manage_autodms 키워드 기반 댓글-DM 퍼널 구성
get_analytics / get_post_analytics 도달, 노출, 참여도 가져오기

직접 API를 찾고 계신가요? Instagram API 페이지를 참고하세요.

Instagram MCP 서버를 Claude나 Cursor에 추가하기

mcp.upload-post.com/mcp에 호스팅된 서버 하나로 끝납니다. 클라이언트가 지원하는 방식에 맞춰 OAuth로 로그인하거나 Upload-Post API 키를 붙여 넣으세요.

Claude Desktop

Settings > Developer > Edit Config에서 파일을 열고 항목을 붙여 넣은 뒤 Claude Desktop을 다시 시작하세요. 내 컴퓨터에서 오픈소스 npm 패키지 @upload-post/mcp를 실행하며, Node.js 18 이상이 필요합니다.

파일 없이 하고 싶나요? claude.ai나 Claude Desktop에서는 Claude 디렉터리(claude.ai/directory/upload-post, 또는 Customize > Connectors에서 Upload-Post 검색)에서 공식 Upload-Post 커넥터를 추가하고 Connect를 클릭한 뒤 Upload-Post 계정으로 로그인(OAuth)하세요.

claude_desktop_config.json
{
  "mcpServers": {
    "upload-post": {
      "command": "npx",
      "args": ["-y", "@upload-post/mcp"],
      "env": { "UPLOAD_POST_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code

OAuth가 편하다면 --header 줄을 빼고, Claude Code 안에서 /mcp를 실행해 로그인하세요. 모든 프로젝트에서 서버를 쓰려면 --scope user를 추가합니다.

Terminal
claude mcp add --transport http upload-post https://mcp.upload-post.com/mcp \
  --header "Authorization: ApiKey YOUR_API_KEY"

Cursor

프로젝트 하나에만 쓰려면 .cursor/mcp.json에, 모든 프로젝트에 쓰려면 ~/.cursor/mcp.json에 넣고 Cursor를 다시 불러오세요.

.cursor/mcp.json
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

API 키는 app.upload-post.com의 API Keys 메뉴에 있습니다. 첫 게시 전에 대시보드에서 Instagram 계정을 프로필에 연결하세요. 에이전트는 그 프로필 이름을 user 값으로 넘깁니다. ChatGPT에서는 Apps에서 Upload-Post를 검색해 Connect를 누르면 되고, 설정 파일은 필요 없습니다.

예시: 공동 작업자, 커버, 첫 댓글이 있는 릴스

이름, ID, URL은 예시용이며 실제 고객 대화가 아닙니다. 도구 이름과 파라미터는 서버가 실제로 제공하는 그대로입니다.

사용자

https://example.com/reels/latte-art.mp4 를 프로필 "cafe"에 릴스로 올려 줘. 캡션: "슬로모션으로 보는 라테 아트". @northbakery를 공동 작업자로 추가하고, https://example.com/covers/latte.jpg 를 커버로 쓰고, 피드에도 보이게 하고, 첫 댓글에 우리 해시태그를 달아 줘.

  1. 도구 호출 1

    upload_video

    호출 한 번으로 릴스 위치, 커버, 공동 작업자, 첫 댓글을 설정합니다.

    arguments
    {
      "videoPathOrUrl": "https://example.com/reels/latte-art.mp4",
      "user": "cafe",
      "platforms": [
        "instagram"
      ],
      "title": "슬로모션으로 보는 라테 아트",
      "firstComment": "#latteart #coffee #baristalife",
      "asyncUpload": true,
      "platformOptions": {
        "instagramMediaType": "REELS",
        "instagramShareToFeed": true,
        "instagramCoverUrl": "https://example.com/covers/latte.jpg",
        "instagramCollaborators": "northbakery"
      }
    }
    result (일부 생략)
    {
      "success": true,
      "message": "Upload initiated successfully in background.",
      "request_id": "4b8e2c1d-7a3f-4e59-b6d2-0c9a1f5e7d33",
      "total_platforms": 1
    }
  2. 도구 호출 2

    get_status

    Instagram이 릴스 처리를 끝낼 때까지 상태를 조회합니다.

    arguments
    {
      "requestId": "4b8e2c1d-7a3f-4e59-b6d2-0c9a1f5e7d33"
    }
    result (일부 생략)
    {
      "request_id": "4b8e2c1d-7a3f-4e59-b6d2-0c9a1f5e7d33",
      "status": "completed",
      "completed": 1,
      "total": 1,
      "results": [
        {
          "platform": "instagram",
          "success": true
        }
      ]
    }

어시스턴트

"cafe"에 릴스가 올라갔습니다. @northbakery를 공동 작업자로 초대했고, 지정한 커버를 쓰고, 첫 댓글에 해시태그를 달았습니다. 피드에도 표시됩니다.

  • scheduledDate와 timezone을 더하면 지금 게시하는 대신 릴스를 예약합니다.
  • 동영상과 커버는 공개 URL에 있어야 합니다. 호스팅된 MCP 서버는 내 컴퓨터의 파일을 읽을 수 없습니다.

캐러셀과 스토리

upload_photos: 피드 캐러셀. Instagram은 최대 10개 항목까지 허용합니다.

{
  "photosPathsOrUrls": [
    "https://example.com/menu/1.jpg",
    "https://example.com/menu/2.jpg",
    "https://example.com/menu/3.jpg"
  ],
  "user": "cafe",
  "platforms": [
    "instagram"
  ],
  "title": "가을 메뉴, 음료 하나에 슬라이드 한 장.",
  "platformOptions": {
    "instagramMediaType": "IMAGE"
  }
}

upload_photos: 같은 도구로 위치를 STORIES로 지정하면 스토리가 올라갑니다.

{
  "photosPathsOrUrls": [
    "https://example.com/stories/today.jpg"
  ],
  "user": "cafe",
  "platforms": [
    "instagram"
  ],
  "platformOptions": {
    "instagramMediaType": "STORIES"
  }
}

공식 Instagram API, 내 Meta 앱은 필요 없습니다

Instagram MCP 서버가 내 계정에 접근하는 방식.

게시는 Instagram 로그인으로 연결된 Upload-Post의 승인된 Meta 앱을 통해 Meta의 Instagram API로 이뤄집니다. Meta 개발자 앱을 등록하거나, App Review를 거치거나, 토큰 갱신 코드를 짤 필요가 없습니다. 내 비밀번호로 로그인하거나 Instagram 앱을 자동 조작하는 일도 없습니다.

계정은 비즈니스 또는 크리에이터 계정이어야 합니다. Facebook 페이지를 연결할 필요는 없습니다. 개인 계정은 Instagram API로 아예 게시할 수 없으니, 개인 계정이라면 먼저 계정 유형을 바꾸세요.

댓글, 비공개 답장, DM, 댓글에서 DM으로 이어지는 자동화도 같은 API를 거치므로, 에이전트가 자신이 올린 게시물에서 사람들에게 답할 수 있습니다.

출처: Instagram 콘텐츠 게시 (Meta), Upload-Post Instagram 가이드, GitHub의 upload-post-mcp.

에이전트가 지키는 Instagram 한도

Instagram과 Upload-Post가 게시물 하나에 허용하는 범위, 2026년 9월 확인.

항목 한도 출처
계정 유형 비즈니스 또는 크리에이터. Instagram 로그인을 쓰면 Facebook 페이지가 필요 없습니다. Upload-Post Instagram 가이드
캡션 2,200자. 대체 텍스트는 이미지당 최대 1,000자 Upload-Post 글자 수 제한
캐러셀 이미지, 동영상 또는 둘을 섞어 최대 10개 Instagram 콘텐츠 게시 (Meta)
릴스 동영상 MP4 또는 MOV, 3초~15분, 최대 300MB, 23~60fps. 스토리 동영상은 최대 100MB. Upload-Post 동영상 요건
사진 최대 8MB, 너비 320~1440px, 가로세로 비율 4:5~1.91:1 Upload-Post 사진 요건

모든 MCP 클라이언트와 호환

같은 서버, 같은 도구입니다. AI 클라이언트를 선택하고 3단계 가이드를 따라 하세요.

이 Instagram 프롬프트들을 시도해 보세요

외울 명령어는 없습니다. 원하는 것을 설명하세요.

“이 사진을 "marketing" 프로필로 Instagram에 게시하세요. 캡션: "신상품 출시 🔥".”
“최신 게시물에 "PRICE"라고 댓글 단 모든 사람에게 비공개로 답글을 달아주세요.”
“자동 DM을 설정해 주세요: 누군가 "GUIDE"라고 댓글을 달면 다운로드 링크를 보내도록요.”
“이번 달 릴스 성과는 사진 게시물과 비교해 어땠나요?”

자주 묻는 질문

Instagram + AI 에이전트에 관한 모든 것. 최종 업데이트: 2026년 9월.

Instagram MCP 서버란 무엇인가요?

Instagram MCP 서버는 Instagram 작업(릴스, 사진, 댓글, DM)을 AI 에이전트가 호출할 수 있는 도구로 노출하는 Model Context Protocol 서버입니다. Upload-Post MCP 서버를 사용하면 ChatGPT, Claude, Gemini 또는 모든 MCP 클라이언트가 별도의 코드 없이 프롬프트로 Instagram을 관리할 수 있습니다.

AI 에이전트가 Instagram에 릴스를 게시할 수 있나요?

네. Instagram 계정을 Upload-Post에 한 번 연결하고 AI 클라이언트에 MCP 서버를 추가하면, 에이전트가 캡션과 예약 설정과 함께 릴스, 사진, 캐러셀을 게시할 수 있습니다.

에이전트가 댓글과 DM에 답할 수 있나요?

네. 서버에는 댓글을 읽고, 공개 또는 비공개로 답글을 달고, DM을 보내고, 키워드 기반 댓글-DM 자동화까지 구성하는 도구가 포함되어 있습니다.

Instagram MCP 서버는 무료인가요?

MCP 서버는 MIT 라이선스의 무료 오픈 소스입니다. 무료 요금제를 포함한 모든 Upload-Post 요금제에서 작동합니다.

Instagram 스크래핑 MCP 서버와 무엇이 다른가요?

많은 Instagram MCP 서버는 공개 프로필, 게시물, 해시태그를 스크래핑으로 읽습니다. 보통 서드파티 스크래퍼나 로그인된 세션을 이용합니다. 이 서버는 정반대입니다. 직접 연결한 비즈니스 또는 크리에이터 계정을 Meta의 공식 Instagram API로 관리합니다. 릴스, 캐러셀, 스토리를 게시하고 댓글과 DM에 답하며 내 계정의 분석을 읽습니다. 다른 계정의 데이터는 수집하지 않습니다.

Meta 개발자 앱이나 Facebook 페이지가 필요한가요?

둘 다 필요 없습니다. API 접근은 Upload-Post의 승인된 Meta 앱이 처리하고, 연결은 Instagram 로그인으로 합니다. Instagram 계정은 비즈니스 또는 크리에이터 계정이어야 하며, Facebook 페이지 연결은 필요 없습니다.

스토리와 캐러셀도 올릴 수 있나요?

네. instagramMediaType을 STORIES로 설정하면 스토리(사진 또는 동영상)가 올라갑니다. 이미지 여러 장으로 upload_photos를 호출하면 최대 10개 항목의 피드 캐러셀이 게시됩니다.

공동 작업자, 커버, 첫 댓글도 넣을 수 있나요?

네. 릴스에서 instagramCollaborators는 공동 작업자를 초대하고, instagramCoverUrl은 커버를 정하고, instagramShareToFeed는 릴스를 피드에도 보여 줍니다. firstComment는 게시 직후 댓글을 답니다.

AI 에이전트에게 Instagram 운영을 맡기세요

무료로 시작, 신용카드 불필요. Instagram 계정을 한 번 연결하면 어떤 MCP 클라이언트에서든 게시할 수 있습니다.