Endpoint HTTP MCP — integracoes server-to-server

Quando usar HTTP em vez de stdio

• Voce esta integrando de um servidor (n8n, Make, Zapier, AWS Lambda, Vercel Functions).
• Voce esta construindo um agente hospedado que precisa falar com o EuGestor.
• Voce nao tem controle sobre o ambiente do cliente (web, mobile).

Para uso local com Claude Desktop, prefira stdio (mais rapido, sem rede). Veja mcp-claude-desktop.

Endpoint

POST https://core.eugestor.net/api/mcp
Authorization: Bearer eg_sua_chave
Content-Type: application/json

Listar ferramentas disponiveis

curl https://core.eugestor.net/api/mcp \
  -H "Authorization: Bearer eg_sua_chave"

Resposta:

{
  "tools": ["get_tasks", "create_task", "update_task", "block_task",
            "get_okrs", "create_okr", "update_kr_progress",
            "get_meetings", "schedule_meeting", "get_smart_briefing",
            "get_engagement_score", "get_leaderboard", "award_bonus_xp",
            "get_team_health", "get_neuro_nudge"]
}

Chamar uma ferramenta

curl -X POST https://core.eugestor.net/api/mcp \
  -H "Authorization: Bearer eg_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "get_tasks",
    "input": { "tenant_id": "uuid-do-workspace", "status": "in_progress" }
  }'

Formato de resposta

Todas as respostas seguem o padrao { data, error }:

{ "data": "...resultado da ferramenta...", "error": null }

Em caso de erro:

{ "data": null, "error": "Mensagem descritiva" }

Limites e seguranca

• Plano Pro+ obrigatorio (verificado a cada request).
• Rate limit: 60 requests/usuario/minuto.
• Permissoes granulares: cada chave so consegue chamar tools dos modulos que voce marcou ao criar.
• Revogacao instantanea: ao revogar a chave em Configuracoes, todas as integracoes que a usam param de funcionar imediatamente.

Exemplo: criar tarefa via n8n

1. Adicione um node HTTP Request.
2. Method: POST | URL: https://core.eugestor.net/api/mcp.
3. Header: Authorization: Bearer {{ $env.EUGESTOR_KEY }}.
4. Body (JSON):

{
  "tool": "create_task",
  "input": {
    "tenant_id": "{{ $json.tenant_id }}",
    "title": "{{ $json.titulo }}",
    "priority": "high",
    "urgency": "high",
    "owner_user_id": "{{ $json.user_id }}"
  }
}

Pronto — agora seu fluxo n8n cria tarefas no EuGestor.