> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Visão Geral das Integrações > Como o EvoNexus conecta a serviços externos via MCP, APIs e OAuth # 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. | Channel | Plataforma | Comando Make | Guia | | - | - | - | - | | Telegram | Mobile/Desktop | `make telegram` | [Setup](../guides/channels#setup-telegram) | | Discord | Desktop/Mobile | `make discord-channel` | [Setup](../guides/channels#setup-discord-channel) | | iMessage | apenas macOS | `make imessage` | [Setup](../guides/channels#setup-imessage) | > **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](../guides/channels) | Referência técnica: [Channels Reference](../guides/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. | Integração | MCP Server | Usado por | | - | - | - | | Google Calendar | `google-calendar` | @clawdia (agenda, agendamento) | | Gmail | `gmail` | @clawdia (triagem, drafts, envio) | | GitHub | `github` | @atlas (PRs, issues, releases) | | Linear | `linear-server` | @atlas (issues, sprints) | | Telegram | `plugin:telegram` | @clawdia (notificações, bot) | | Canva | `canva` | @pixel (designs, apresentações) | | Notion | `claude_ai_Notion` | Base de conhecimento | 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. | Integração | Usado por | Skills | | - | - | - | | Stripe | @flux | `int-stripe`, `fin-daily-pulse`, `fin-weekly-report` | | Omie | @flux | `int-omie`, `fin-monthly-close-kickoff` | | Bling | @flux | `int-bling`, `fin-daily-pulse`, `fin-monthly-close-kickoff` | | Asaas | @flux | `int-asaas`, `fin-daily-pulse`, `fin-weekly-report` | | Discord | @pulse | `discord-get-messages`, `pulse-daily`, `pulse-weekly` | | Fathom | @clawdia | `int-fathom`, `int-sync-meetings` | | YouTube | @pixel | `int-youtube`, `social-youtube-report` | | Instagram | @pixel | `int-instagram`, `social-instagram-report` | | LinkedIn | @pixel | `int-linkedin`, `social-linkedin-report` | | Evolution API | @pulse | `int-evolution-api`, `pulse-daily` | | Evolution Go | @pulse | `int-evolution-go`, `pulse-daily` | | Evo CRM | @nex | `int-evo-crm` | 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`: ```env theme={null} # YouTube YOUTUBE_OAUTH_CLIENT_ID=... YOUTUBE_OAUTH_CLIENT_SECRET=... # Instagram / Meta META_APP_ID=... META_APP_SECRET=... # LinkedIn LINKEDIN_CLIENT_ID=... LINKEDIN_CLIENT_SECRET=... ``` ## 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 ```bash theme={null} # Testar uma integração específica make community # testa Discord make fin-pulse # testa Stripe + Omie make github # testa GitHub make social # testa YouTube + Instagram + LinkedIn ``` ## 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](stripe) — MRR, cobranças, assinaturas, churn * [Omie](omie) — ERP brasileiro: clientes, notas, financeiro, estoque * [Bling](bling) — ERP brasileiro: produtos, pedidos, NF-e, estoque (OAuth2 com auto-refresh) * [Asaas](asaas) — Pagamentos brasileiros: Pix, boleto, cartão, assinaturas, split de marketplace **Reuniões & Tarefas:** * [Fathom](fathom) — Gravações, transcrições, action items de reunião * [Todoist](todoist) — Gestão de tarefas via CLI **Mensageria:** * [Telegram](telegram) — Mensagens e notificações via bot (MCP) * [Discord](discord) — Canais e mensagens de comunidade **Redes Sociais:** * [YouTube](youtube) — Stats de canal, vídeos, engajamento (OAuth) * [Instagram](instagram) — Perfil, posts, engajamento (Graph API + OAuth) * [LinkedIn](linkedin) — Perfil e stats de organização (OAuth) **Desenvolvimento:** * [GitHub](github) — PRs, issues, releases via MCP + CLI * [Linear](linear) — Issues, sprints, acompanhamento de projeto via MCP **Produtividade:** * [Google Calendar + Gmail](google) — Agenda, agendamento, triagem de e-mail * [Obsidian](obsidian) — Gestão de vault, notas, busca via CLI **Plataforma Evolution:** * [Evolution API](evolution-api) — Instâncias e mensageria WhatsApp * [Evolution Go](evolution-go) — Instâncias Evolution Go * [Evo CRM](evo-crm) — Contatos, conversas, pipelines do CRM ## Suporte a Múltiplas Contas Integrações de redes sociais suportam múltiplas contas por plataforma usando um padrão numerado: ```env theme={null} SOCIAL_YOUTUBE_1_LABEL=Canal Principal SOCIAL_YOUTUBE_1_ACCESS_TOKEN=ya29... SOCIAL_YOUTUBE_1_CHANNEL_ID=UC... SOCIAL_YOUTUBE_2_LABEL=Segundo Canal SOCIAL_YOUTUBE_2_ACCESS_TOKEN=ya29... SOCIAL_YOUTUBE_2_CHANNEL_ID=UC... ``` Skills de analytics agregam automaticamente entre todas as contas conectadas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.