instagram-mcp-server

Servidor MCP para publicação automática no Instagram — imagem única, carrossel e Reels — via Instagram Graph API oficial. Projetado para ser operado por um agente (Claude) e rodar no Coolify.

O conteúdo (imagem/vídeo/legenda) é gerado por IA no momento da operação: o agente gera a mídia, hospeda com instagram_upload_media e publica com a tool correspondente. Cada tool executa o fluxo completo da Graph API (cria container → aguarda processamento → publica) em uma única chamada.

Tools expostas

Related MCP server: @node2flow/instagram-mcp

Pré-requisitos na Meta (fazer uma vez)

Este servidor usa por padrão a Instagram API with Instagram Login (token IGAA…, endpoint graph.instagram.com) — a rota moderna que dispensa Página do Facebook.

1. Conta Instagram Business ou Creator.

2. Em developers.facebook.com: criar um App, adicionar o produto Instagram e configurar Instagram Login (Business).

3. Solicitar as permissões instagram_business_content_publish e instagram_business_basic. Para uso em produção, passar pela App Review da Meta.

4. Gerar um long-lived access token (IGAA…) e anotar o Instagram User ID (via GET https://graph.instagram.com/v21.0/me?fields=user_id,username).

Guarde IG_USER_ID e IG_ACCESS_TOKEN.

Rota alternativa (Facebook Login): se preferir o token EAA… via Página do Facebook, defina IG_API_BASE=https://graph.facebook.com/v21.0 e siga o fluxo fb_exchange_token para o token.

Deploy no Coolify

1. Aponte o Coolify para este repositório (build por Dockerfile ou docker-compose).

2. Defina um domínio público para o serviço (ex.: insta-mcp.duarteapps.cloud) — o Coolify já emite o TLS via Cloudflare.

3. Configure as variáveis de ambiente (ver .env.example):

   • IG_USER_ID, IG_ACCESS_TOKEN

   • PUBLIC_BASE_URL = o domínio público acima (a Graph API baixa a mídia daqui)

   • MCP_AUTH_TOKEN = um token aleatório forte

   • (opcional) FB_APP_ID, FB_APP_SECRET para renovar o token

4. Garanta que a porta 3000 está exposta e o healthcheck aponta para /health.

O endpoint MCP fica em https://insta-mcp.duarteapps.cloud/mcp.

Conectar como MCP no Claude

Adicione um conector MCP HTTP:

• URL: https://insta-mcp.duarteapps.cloud/mcp

• Header: Authorization: Bearer <MCP_AUTH_TOKEN>

Teste rápido:

curl -X POST https://insta-mcp.duarteapps.cloud/mcp \
  -H "Authorization: Bearer $MCP_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Fluxo típico operado pelo agente

1. instagram_get_account → confirma que a conta/token estão OK.

2. (IA gera a imagem/vídeo) → instagram_upload_media → recebe a url.

3. instagram_publish_image / _carousel / _reel com a url + caption.

4. instagram_publishing_limit → confere a cota antes de lotes.

Requisitos de mídia (resumo)

• Imagem: JPG/PNG, 4:5 a 1.91:1, até 8 MB.

• Reel: MP4/MOV H.264, 3 s a 15 min, até ~1 GB, 9:16 recomendado.

• Carrossel: 2 a 10 itens.

Limitações da API (por design da Meta)

• Stories têm suporte limitado na Content Publishing API.

• Curtir, seguir, comentar e enviar DM automatizados são proibidos pelos Termos — não implementados aqui de propósito.

• ~50 publicações por conta a cada 24 h.

Desenvolvimento local

npm install
npm run build
MCP_AUTH_TOKEN=dev PUBLIC_BASE_URL=http://localhost:3000 \
IG_USER_ID=... IG_ACCESS_TOKEN=... npm start