하나의 MCP URL로 Claude 또는 Cursor에 공개 인스타그램 데이터 읽기 전용 접근 권한 부여하기
요약
본 문서는 AI 어시스턴트가 공개 인스타그램 데이터를 읽기 전용으로 접근할 수 있도록 원격 MCP(Multi-Client Protocol) 서버 구축 방법을 안내합니다. Claude Code, Cursor, VS Code 등 다양한 클라이언트에서 해당 서버를 추가하고 로그인하는 구체적인 절차와 명령어 예시를 제공합니다.
핵심 포인트
- MCP를 통해 AI 어시스턴트가 공개 인스타그램 데이터에 접근 가능해졌습니다.
- Claude Code 및 Cursor 등의 개발 환경에서 전용 명령어로 MCP를 쉽게 연결할 수 있습니다.
- 접근은 읽기 전용(readOnly)이며, API 키 또는 OAuth 로그인을 사용해야 합니다.
- 호출마다 월별 할당량 크레딧이 차감되므로 비용 관리가 필요합니다.
AI 어시스턴트에게 인스타그램 계정에 대해 질문하면 보통 추측만 합니다. 따라서 경쟁사나 연구하고 싶은 크리에이터에게 도움을 줄 수 없습니다.
이를 위해 저희는 원격 MCP(Multi-Client Protocol) 서버를 구축했습니다. 브라우저에서 한 번 로그인하면, 어시스턴트는 프로필, 게시물, 릴스, 스토리, 하이라이트, 댓글, 해시태그, 장소, 오디오 등 공개 인스타그램 데이터를 위한 20가지 이상의 도구를 사용하게 됩니다.
클라이언트에 추가하기
해당 서버는 https://data.fastsocial.co/mcp에서 Streamable HTTP를 통해 MCP를 전송합니다.
Claude Code
claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp
그런 다음 /mcp를 실행하고 instagram-data를 선택한 후 로그인합니다.
Cursor (.cursor/mcp.json 또는 ~/.cursor/mcp.json)
{
"mcpServers": {
"instagram-data": {
...
VS Code (.vscode/mcp.json)
{
"servers": {
"instagram-data": {
...
Claude 앱: 설정(Settings) > 커넥터(Connectors) > 사용자 지정 커넥터 추가(Add a custom connector) > URL 붙여넣기 > OAuth 필드는 비워둡니다.
첫 연결 시 로그인 페이지가 열립니다. 이메일을 입력하고 받은 코드를 타이핑한 후 허용(Allow)을 클릭합니다. 계정이 없는 경우 무료 플랜이 생성됩니다.
클라이언트에서 헤더를 설정할 수 있지만 브라우저 로그인은 할 수 없는 경우, 대신 API 키를 사용하세요:
claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp --header "X-API-Key: YOUR_KEY"
무엇을 질문할 수 있나요?
연결이 완료되면 일반적인 질문도 가능합니다:
-
공개 데이터만 가능합니다. 비공개 계정의 경우
private_account오류가 반환됩니다. -
계정 소유자는 옵트아웃(opt out)을 선택할 수 있으며, 이 경우 해당 계정은
451 opted_out을 반환합니다. -
호출(call)마다 월별 할당량에서 크레딧이 차감되며, 호출당 1개에서 3개의 크레딧이 소요됩니다.
-
모든 도구는
readOnlyHint: true로 표시되어 있습니다. 쓰기(write) 또는 삭제(delete) 도구는 없습니다.
만약 클라이언트가 로컬 stdio 서버만 실행하는 경우, 동일한 도구들이 PyPI에서 instagram-data-mcp라는 이름으로 제공됩니다.
링크
- API 및 플랜: fastsocial.co/instagram-api
- 문서 및 OpenAPI 사양: fastsocial.co/instagram-api/docs
- MCP 레지스트리:
io.github.FastSocialCo/instagram-data-mcp
코딩 없이 스토리만 보고 싶다면, 동일한 백엔드가 무료 Instagram 스토리 뷰어를 운영하고 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기