Skip to main content

​
Visão Geral das Integrações

O EvoNexus se conecta a serviços externos através de três mecanismos: MCP servers, API clients e OAuth flows. Cada integração fornece dados a um ou mais agentes e rotinas. Visão geral de integrações

​
Channels (Bidirecionais)

Channels são um tipo diferente de integração: sistemas externos empurram eventos para sua sessão Claude Code rodando, e o Claude pode responder de volta pelo mesmo canal. Diferente de API clients (que o Claude chama sob demanda) ou MCP servers (que expõem ferramentas), channels entregam mensagens em tempo real.
Nota: o channel do Discord (chat bidirecional com Claude Code) é separado da integração Discord API (monitoramento de comunidade via @pulse). Os dois podem coexistir.
Guia completo: Channels | Referência técnica: Channels Reference

​
Tipos de Integração

​
MCP Servers

Servers do Model Context Protocol rodam como processos sidecar junto com o Claude Code. Eles expõem ferramentas que o Claude pode chamar nativamente durante uma sessão. MCP servers são configurados em .claude/settings.json. O Claude Code os inicia automaticamente quando suas ferramentas são necessárias.

​
API Clients

Chamadas HTTP diretas para APIs de serviços, executadas por skills e rotinas via scripts Python. API clients leem credenciais de .env em tempo de execução.

​
OAuth Flows

Contas de redes sociais (YouTube, Instagram, LinkedIn) usam OAuth para autenticação. O dashboard tem um fluxo OAuth embutido:
  1. Vá em Integrations no dashboard
  2. Clique em Connect na plataforma desejada
  3. Complete a tela de consentimento OAuth
  4. Os tokens são salvos no .env automaticamente
OAuth exige credenciais de cliente configuradas no .env:

​
Verificando o Status das Integrações

​
Dashboard

A página Integrations mostra um card de status para cada serviço:
  • Verde — conectada e funcionando
  • Amarelo — credenciais presentes mas não verificadas
  • Vermelho — credenciais ausentes

​
CLI

​
Configuração

Todas as credenciais de integração ficam em .env. O wizard de setup (make setup) gera esse arquivo com placeholders vazios para cada integração habilitada. Você pode editar credenciais por:
  • O editor de .env do dashboard (Config > .env)
  • Direto no terminal: nano .env
Veja os guias de cada integração para os passos de setup: Financeiro & ERP:
  • Stripe — MRR, cobranças, assinaturas, churn
  • Omie — ERP brasileiro: clientes, notas, financeiro, estoque
  • Bling — ERP brasileiro: produtos, pedidos, NF-e, estoque (OAuth2 com auto-refresh)
  • Asaas — Pagamentos brasileiros: Pix, boleto, cartão, assinaturas, split de marketplace
Reuniões & Tarefas:
  • Fathom — Gravações, transcrições, action items de reunião
  • Todoist — Gestão de tarefas via CLI
Mensageria:
  • Telegram — Mensagens e notificações via bot (MCP)
  • Discord — Canais e mensagens de comunidade
Redes Sociais:
  • YouTube — Stats de canal, vídeos, engajamento (OAuth)
  • Instagram — Perfil, posts, engajamento (Graph API + OAuth)
  • LinkedIn — Perfil e stats de organização (OAuth)
Desenvolvimento:
  • GitHub — PRs, issues, releases via MCP + CLI
  • Linear — Issues, sprints, acompanhamento de projeto via MCP
Produtividade: Plataforma Evolution:

​
Suporte a Múltiplas Contas

Integrações de redes sociais suportam múltiplas contas por plataforma usando um padrão numerado:
Skills de analytics agregam automaticamente entre todas as contas conectadas.