Servidor MCP easyCoexistence: todas as ferramentas por rede
O servidor MCP do easyCoexistence dá ao Claude, ao ChatGPT e a outros clientes MCP 72 ferramentas para WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e outros canais: publicação e agendamento, comentários, respostas a DMs, métricas, regras de comentário para DM, automatizações e qualquer outro endpoint da API oficial de cada rede, através de um único conector com início de sessão por OAuth.
Adicione-o no Claude como conector personalizado ou no ChatGPT como servidor MCP personalizado, e depois inicie sessão: como adicionar o conector. As ferramentas que uma sessão vê seguem o que a conta tem ligado.
WhatsApp 12
Um número ligado através do Coexistence: estado, mensagens dentro da janela de 24 horas, templates e o destino das suas mensagens.
Servidor MCP do WhatsApp para Claude, ChatGPT e Cursor
list_numbers- Liste os números comerciais de telefone ligados do utilizador, com o estado da ligação, a classificação de qualidade e o nível de mensagens. Comece aqui: as outras ferramentas recebem um connection_id desta lista.
get_number_health- Panorama completo de saúde de um número: instantâneo em tempo real da Meta (qualidade, estado da ligação de coexistência) e o histórico recente de monitorização (webhooks e verificações do poller).
get_api_credentials- Credenciais para integrar este número com um sistema externo (n8n, CRM, código próprio): URL base da Graph API, WABA ID, ID do número de telefone e, quando disponível, o token de acesso do próprio utilizador. São para envio. Para receber, use set_webhook_destination com um webhook genérico (no n8n, o nó Webhook, não o WhatsApp Trigger). Não existe segredo de aplicação para obter; veja get_docs, secção 'Securing the webhook'.
send_message- Envie uma mensagem de texto livre a partir do número comercial do utilizador, através da API oficial. Só funciona dentro de uma janela de atendimento: o destinatário tem de ter escrito a este número nas últimas 24 horas (estas respostas são gratuitas). Para iniciar uma conversa com alguém que ainda não escreveu, use send_template com um template aprovado.
list_templates- Liste os templates de mensagem da conta WhatsApp Business deste número, com o respetivo estado de revisão. Na coexistência, os templates só podem ser enviados pela API: a aplicação do telemóvel não os consegue enviar.
create_template- Crie um template de mensagem e submeta-o à revisão da Meta (a aprovação costuma demorar minutos, até cerca de 24 horas). Categorias: UTILITY (transacional), MARKETING (promocional, exige um método de pagamento na conta WhatsApp Business do utilizador), AUTHENTICATION. Os componentes seguem o formato de templates da Meta, por exemplo [{type:'BODY', text:'Olá {{1}}, o seu pedido foi enviado.'}]. As variáveis são {{1}}, {{2}}… e precisam de valores de exemplo: {type:'BODY', text:'…', example:{body_text:[['Ana']]}}.
get_template_status- Verifique o estado de revisão de um template pelo nome (APPROVED / PENDING / REJECTED).
send_template- Envie uma mensagem com um template APPROVED. É assim que se inicia uma conversa com alguém que ainda não escreveu primeiro. Os envios de marketing são faturados pela Meta ao método de pagamento da conta WhatsApp Business do utilizador (configurado no WhatsApp Manager; não é possível adicionar cartões por API).
set_webhook_destination- Encaminhe as mensagens recebidas deste número (e os ecos das mensagens enviadas a partir da aplicação do telemóvel) diretamente da Meta para o sistema do próprio utilizador: a easyCoexistence nunca guarda nem retransmite o conteúdo. O destino tem de ser um endpoint HTTPS que implemente o handshake de webhook da Meta: num GET com hub.mode=subscribe e hub.verify_token=<verify_token>, devolva hub.challenge. A Meta assina cada POST (X-Hub-Signature-256) com o segredo da aplicação da easyCoexistence, que nunca é partilhado; por isso o destino não consegue validar esse cabeçalho. Não ative a validação de assinatura aí e use um recetor de webhook genérico (no n8n, o nó Webhook simples, não o nó WhatsApp Trigger, que espera a aplicação Meta do próprio utilizador). Autentique as entregas com um segredo longo e aleatório dentro do próprio callback_url (no caminho ou na query string), que o endpoint verifica em cada pedido; get_docs, secção 'Securing the webhook', tem os detalhes. Se for guardado nas 24 horas após a ligação do número, recebe também a importação única dos contactos do número e até 6 meses de conversas pela Meta (webhooks de histórico, concluídos quando metadata.progress for 100), por isso configure-o logo após a ligação, se as conversas passadas forem importantes. Chame com callback_url=null para repor o encaminhamento.
remove_number- Remove a number from easyCoexistence (the dashboard's Remove, DELETE /api/v1/connections/:id): our access at Meta is revoked, monitoring stops, billing stops at the end of the cycle, and its automations stop. The number keeps working on the Cloud API until the business disconnects it in the WhatsApp Business app. Requires confirm=true, only after the user explicitly asks to remove that number.
get_connect_link- Como ligar um número novo. A ligação exige um navegador (janela pop-up da Meta e leitura de código QR), por isso esta ferramenta devolve o URL do painel e os passos, e também por onde começar quando o utilizador quer que os seus próprios clientes liguem números a partir do software dele (a Partner API).
get_docs- A documentação do produto easyCoexistence (markdown): o que é a Coexistence, como funciona a ligação, regras de elegibilidade dos números e bloqueios comuns na integração, regras de envio (janela de 24 horas, templates), encaminhamento de webhooks, monitorização e a regra dos 14 dias, e a Partner API passo a passo (para um SaaS ou agência que liga os números dos próprios clientes). Use para responder a qualquer pergunta sobre o funcionamento da easyCoexistence.
Instagram e Facebook 12
Publicações, comentários, respostas privadas, respostas a DMs dentro da janela de 24 horas, métricas e regras de comentário para DM, em contas do Instagram e páginas do Facebook.
Servidor MCP do Instagram para Claude e ChatGPT · Servidor MCP do Facebook para Claude e ChatGPT
publish_instagram_post- Publish to Instagram now: IMAGE (image_url), CAROUSEL (items, 2 to 10), REELS (video_url) or STORIES (image_url or video_url). Media must be at a public HTTPS URL Meta can download (JPEG for images). Videos can take minutes to process: a result with status processing is finished by easyCoexistence on its own. Meta caps API publishing at about 100 posts per 24h per account. To post later, pass scheduled_at. Every post gets a post_id (list_scheduled_posts).
publish_facebook_post- Publish to a Facebook Page now, or later with scheduled_at: text (message), a link, a photo (image_url) or a video (video_url).
list_social_posts- Publicações recentes da conta (conteúdos do Instagram, publicações de Páginas ou vídeos do TikTok), com IDs, legendas e contagens.
list_social_comments- Comentários de uma publicação (post_id obtido em list_social_posts).
reply_to_comment- Responda publicamente a um comentário ou, com private=true, responda em privado ao autor do comentário, por DM (a Meta permite uma resposta privada por comentário, no prazo de 7 dias após o comentário).
hide_comment- Oculte um comentário numa publicação da conta (ou, com hide=false, volte a mostrá-lo).
send_social_dm- Envie uma DM (Instagram Direct ou Messenger) a alguém que escreveu à conta nas últimas 24 horas. recipient_id é o id dessa pessoa no evento da mensagem (encaminhado para o destino do webhook).
get_social_insights- Insights da conta (por defeito) ou de uma publicação (object_id). Exemplo de conta do Instagram: metrics ['reach','views','accounts_engaged','follows_and_unfollows'], period 'day', params {metric_type:'total_value'}. Exemplo de publicação: metrics ['reach','likes','comments','saved','shares','views'], sem period. Páginas: por exemplo ['page_impressions_unique','page_post_engagements'], period 'day'. A Meta renomeia métricas entre versões: se uma for rejeitada, o erro indica as válidas. Conta do TikTok: por exemplo ['followers_count','video_views','likes'], uma linha por dia; um vídeo (object_id = o respetivo item_id): por exemplo ['video_views','likes','comments','shares'].
create_comment_rule- Comentário para DM: quando alguém comenta as publicações da conta (ou só o post_id) com alguma das palavras-chave (vazio = todos os comentários), recebe automaticamente uma resposta por DM com o texto dm_text e, se estiver definido, uma public_reply por baixo do comentário. Funciona 24/7 na easyCoexistence, sem agente. O TikTok não tem DMs: nas contas do TikTok, passe apenas public_reply. Confirme o texto com o utilizador antes de criar.
list_comment_rules- As regras de comentário para mensagem direta da conta, com o número de comentários a que cada uma já respondeu.
update_comment_rule- Pausa ou retoma uma regra de comentário para mensagem direta (active), ou elimina-a (delete=true, depois de o utilizador confirmar).
remove_social_account- Remove a channel from easyCoexistence (the dashboard's Remove this channel, DELETE /api/v1/channels/:id): access is revoked at the network, the token is forgotten, its scheduled posts are canceled, its automations stop and billing stops at the end of the cycle. Coming back means connecting it again. Requires confirm=true, only after the user explicitly asks to remove that channel.
TikTok 3
Vídeos e publicações de fotografias, o respetivo estado de publicação e os comentários da própria conta.
Servidor MCP do TikTok para Claude e ChatGPT
publish_tiktok_post- Publish to a connected TikTok account: a video (video_url: MP4/MOV/WebM, 3 to 600 s, up to 1 GB, at least 360 px) or a photo post (image_urls: 1 to 35 JPEG or WebP; TikTok refuses PNG). Media must be at a public HTTPS URL. TikTok processes the post asynchronously: the result has a share_id, pass it to get_tiktok_publish_status. TikTok caps API posting at about 15 posts per day per account. To post later, pass scheduled_at. Every post gets a post_id (list_scheduled_posts).
get_tiktok_publish_status- Estado de uma publicação no TikTok iniciada com publish_tiktok_post (share_id do respetivo resultado).
delete_tiktok_comment- Elimina um comentário num dos vídeos da conta TikTok (depois de o utilizador confirmar).
YouTube 6
Carregamentos com o agendamento do YouTube, comentários e a respetiva moderação, e o YouTube Analytics.
upload_youtube_video- Carrega um vídeo para o canal YouTube ligado a partir de um URL HTTPS público. O YouTube exige made_for_kids. A privacidade predefinida é privada. O YouTube agenda nativamente: passe publish_at (ISO 8601) e o vídeo fica público nessa data. Nota: até o projeto Google da easyCoexistence passar na auditoria da API do YouTube, o YouTube mantém os envios feitos pela API como privados.
list_youtube_videos- Os vídeos carregados no canal, do mais recente para o mais antigo, com privacidade, visualizações, gostos e número de comentários.
list_youtube_comments- Conversas de comentários sobre um vídeo (video_id) ou sobre todo o canal, da mais recente para a mais antiga, com respostas. moderation_status heldForReview ou likelySpam lista os comentários à espera de revisão pelo titular.
reply_to_youtube_comment- Responde publicamente a um comentário de primeiro nível, em nome do canal.
moderate_youtube_comment- Aprova (published), retém (heldForReview) ou oculta (rejected) um comentário nos vídeos do canal. Com ban_author e rejected, oculta também os futuros comentários dessa pessoa.
get_youtube_analytics- Estatísticas do YouTube do canal ou de um vídeo (video_id). Valores predefinidos: últimos 28 dias; visualizações, tempo de visualização, duração média de visualização, gostos, comentários, subscritores ganhos e perdidos. dimensions, por exemplo 'day', 'video' (com sort '-views' e max_results), 'country'.
LinkedIn 7
Publicações como página de empresa ou como membro, comentários e estatísticas da página.
publish_linkedin_post- Publish a post on a LinkedIn Page or the member's own profile (account_id decides which). Text up to 3000 characters; optionally one image from a public HTTPS URL (JPG, PNG or GIF), or a link with its title (LinkedIn does not build previews for API posts). Hashtags work as plain #words. Confirm the wording with the user before publishing. To post later, pass scheduled_at. Every post gets a post_id (list_scheduled_posts).
list_linkedin_posts- As publicações de uma Página do LinkedIn, da mais recente para a mais antiga (apenas contas de Página: o LinkedIn não permite às aplicações listar as publicações de um perfil pessoal). Pagine com start = next_start.
list_linkedin_comments- Comentários de uma publicação do LinkedIn (post_id), ou respostas a um comentário (comment_urn). Os autores vêm como URN (urn:li:person:… ou urn:li:organization:…).
comment_on_linkedin_post- Comenta uma publicação como a Página ou como o membro, ou responde a um comentário ao passar parent_comment_urn. Confirma primeiro o texto com o utilizador.
delete_linkedin_comment- Elimina um comentário. Uma Página pode remover qualquer comentário das suas próprias publicações (o LinkedIn não tem ocultação); um perfil só os seus próprios comentários. É irreversível: confirma com o utilizador.
delete_linkedin_post- Elimina uma publicação que a conta publicou. É irreversível: confirma com o utilizador.
get_linkedin_stats- Estatísticas do LinkedIn. Contas de Página: número de seguidores, mais impressões, impressões únicas, cliques, gostos, comentários, partilhas e taxa de envolvimento, acumulados ou por DAY/MONTH entre since e until, opcionalmente para um post_id. Contas de perfil: reações e número de comentários de um post_id.
Automatizações 19
Respostas que funcionam sozinhas, com texto fixo ou com IA, em números, Instagram, Facebook e TikTok.
set_inbound_mode- Como fluem as mensagens recebidas de um número. "managed": a Meta entrega-as à easyCoexistence, as automatizações podem responder, e podem ser reencaminhadas para forward_url, assinadas com um segredo que só o utilizador tem (X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 de "<t>.<body>">); o segredo é devolvido uma única vez. Ativar managed remove um destino de webhook direto. "direct": a Meta entrega diretamente ao destino definido com set_webhook_destination, a easyCoexistence nunca vê as mensagens e as automatizações param. Passe só forward_url para alterar o reencaminhamento de um número managed, ou null para o parar.
list_automations- As automatizações da conta (opcionalmente de um número), com o gatilho, os passos e o estado, e os fornecedores de IA que têm uma chave guardada. Um número tem de estar em managed (set_inbound_mode) para as suas automatizações serem executadas.
create_automation- Create an automation on a number (connection_id from list_numbers) or on an Instagram account, Facebook Page or TikTok account (its channel_id from list_social_accounts, passed as connection_id): a trigger and a flow of steps, with branches (condition, ai_decide), questions that wait for answers (ask), contact fields and tags, any API (http_request), AI agents (agent) and sub-flows (start_automation). The owner keeps answering from the phone app, and the automation pauses on a chat the owner answers. Only one automation answers each message; for one number answering everything with an agent, use match "any" and a single agent step. Test it with test_automation before relying on it.
update_automation- Altera uma automatização. Os campos omitidos mantêm o valor; os passos, quando indicados, substituem a lista inteira. connection_id move-a para outro número ou canal do Instagram, Facebook ou TikTok (o gatilho e os passos têm de ser compatíveis com esse canal).
delete_automation- Elimina uma automatização e o respetivo histórico de execuções.
test_automation- Executa os passos de uma automatização sobre uma mensagem de exemplo, sem enviar nada a ninguém. O passo de IA e o webhook são executados de facto, pelo que o resultado mostra a resposta real. Devolve a execução com o resultado de cada passo.
list_automation_runs- As execuções recentes de uma automatização (últimos 30 dias), da mais recente para a mais antiga: estado (done, failed, skipped, waiting), skip_reason (human_active = o proprietário respondeu há pouco pelo telemóvel, window_closed = passaram mais de 24 h desde que o cliente escreveu, ai_limit, superseded), o resultado e o erro de cada passo, e os tokens de IA utilizados.
get_automation_run- Uma execução com a entrada, a saída, o erro e o tempo de cada passo.
list_agents- The account's AI agents: instructions, model, tools, knowledge items, and which automations use each one.
list_files- The account's pictures and documents (a menu, a price list, photos) that automations and agents can send to customers: id, name, the note saying when to send it, kind (image | document) and the agent it belongs to, if any. Use an id in an automation step {type:"send_file", file_id, caption?}. An agent sends its own files by itself when the note fits the question, so a good note matters. Files are uploaded by the user in the dashboard (the agent's page, section Pictures and files), never through chat.
create_agent- Create an AI agent that answers people for the business, on the user's own AI key. Then add knowledge (add_agent_knowledge), test it (test_agent) and attach it: an automation step {type:"agent", agent_id}. Returns the agent.
update_agent- Change an agent. Fields left out keep their value; tools and settings, when given, replace the whole object.
delete_agent- Delete an agent and its knowledge. Refused while an automation uses it.
add_agent_knowledge- Teach an agent: pass title + content (FAQ, prices, policies, product list; up to 200,000 characters per item) or url: a public https page, or a public link to a file (PDF, Word .docx, Excel .xlsx, PowerPoint .pptx, text, CSV; 20 MB at most), read once now. Only the text is kept. A picture or a scanned PDF behind a link is written out by the agent's own model on the user's key. A file on the user's computer is uploaded in the dashboard instead (the agent's page, Knowledge, Upload a file). Up to 24,000 characters in all go whole into its prompt; past that the agent searches them, so give items clear titles. Pass knowledge_id with title + content to replace an item.
delete_agent_knowledge- Remove one knowledge item from an agent.
test_agent- Chat with an agent without sending anything: pass the conversation so far (messages, the last one from the customer) and optionally a contact {name, fields, tags}. Returns its answer, the tools it called (custom tools really call the user's API), and the contact as it changed it. Nothing is saved. Uses the user's AI key.
list_conversations- People who wrote to the user's managed numbers and social accounts, newest first: name, phone, channels, tags, fields, last message. Filter by q (name or phone), tag, or channel_id. Only numbers and accounts with an automation turned on keep their chats, from the moment it was turned on: an empty list on a number with no automation means nothing was kept, not that nobody wrote (create_automation starts keeping them). Messages are kept for the account's retention (30, 90 or 365 days); contacts stay.
get_conversation- One contact's messages, oldest first (in = the person, out = an automation or agent, with which one, echo = the owner from the phone app), their fields, tags, the agent's notes on them, and whether the bot is paused for them.
update_contact- Change a contact: fields {key: value or null to clear} (keys lower_case_digits_underscore), add_tags, remove_tags, and pause_hours (automatic replies off on their chats for that long; 0 switches them back on). A paused_until in the year 9999 means off until someone switches them on.
Configuração da Partner API 5
Para software que liga os seus próprios clientes: a chave, o URL dos eventos e os links de ligação alojados.
get_partner_setup- Estado da configuração da Partner API, para um utilizador cujo software ou plataforma de agência vai permitir que os clientes DELE liguem números (links de ligação alojados): se a faturação está pronta, se existe uma chave de API, para onde seguem os eventos de estado e qual é o próximo passo. Chame esta ferramenta primeiro quando o utilizador quiser configurar isto e depois guie-o com create_api_key, set_partner_events_url e create_connect_link.
create_api_key- Crie a chave de Partner API da conta (ec_live_…) e devolva-a UMA ÚNICA VEZ. O utilizador tem de a guardar como segredo do lado do servidor. Só há uma chave por conta: se já existir uma, recusa, a não ser que replace_existing=true, porque substituir revoga imediatamente a chave antiga. Passe replace_existing=true apenas depois de o utilizador confirmar explicitamente.
revoke_api_key- Revogue a chave de Partner API da conta (em caso de fuga de uma chave ou para parar a integração). A partir daí, todos os pedidos com ela falham. Exige confirm=true, e só depois de o utilizador pedir explicitamente.
set_partner_events_url- Set the HTTPS URL that receives Partner API status events (connection.connected, .disconnected, .sending_blocked and the rest; the reply lists every event this account gets) and return its signing secret ONCE, with how to verify the X-EC-Signature header. url=null turns events off. When a URL is already set, a new one needs replace_secret=true: it issues a new secret, which breaks the live integration until the user's backend has it.
create_connect_link- Crie um link de ligação alojado (uma sessão de ligação da Partner API) para um dos clientes do utilizador, equivalente a POST /api/v1/connect-sessions: devolve um URL em easycoexistence.com para enviar ao cliente, válido 1 hora. O cliente executa ali o pop-up da Meta e é encaminhado para redirect_url. O número resultante pertence a esta conta e é faturado a esta conta. Use para testar uma configuração da Partner API ou para integrar um cliente manualmente.
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Perguntas frequentes
Quantas ferramentas tem o servidor MCP do easyCoexistence?
72 hoje, listadas nesta página por rede e lidas das próprias definições do servidor, pelo que a lista está sempre atualizada.
Um único conector cobre todas as redes?
Sim. Adicione https://easycoexistence.com/api/mcp uma vez e inicie sessão; as ferramentas chegam a todos os números e contas ligados à sua conta easyCoexistence.
O assistente pode chamar um endpoint que nenhuma ferramenta cobre?
No TikTok, a partir do seu próprio código: get_social_credentials entrega-lhe o token da conta para qualquer endpoint da API for Business do TikTok. No Instagram e no Facebook, não: os respetivos tokens ficam na easyCoexistence, por isso o assistente trabalha através das ferramentas nomeadas.
Quanto custa?
O conector está incluído. As ligações custam de US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, o mesmo em todas as redes, com os primeiros 3 dias gratuitos.