Iniciar sessãoIniciar teste gratuito

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.

https://easycoexistence.com/api/mcp

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.

Todas as contas sociais 8

Ligar uma conta, as respetivas credenciais, qualquer outro endpoint da API da sua rede e o encaminhamento dos seus eventos.

list_social_accounts
Liste os canais sociais ligados à easyCoexistence, com a respetiva rede e o estado do token. Todas as outras ferramentas sociais recebem um account_id daqui.
get_social_connect_link
Como ligar um canal social (exige um navegador para o início de sessão da rede).
get_social_credentials
The account's id and API base, and for TikTok, YouTube and LinkedIn its own access token, for calling the network's API directly (from code, n8n or the user's agent); fetch it fresh rather than storing it, TikTok's rotates. Instagram and Facebook tokens are never handed out (Meta's terms): for those, use the other social tools.
set_social_webhook_destination
Relay this account's comment, mention and DM events to the user's own HTTPS endpoint (their agent, n8n, CRM), signed with a per-account secret returned once. url=null turns it off. The relay itself keeps no copy of the events; an account with automations keeps its DMs for the conversation view.
list_scheduled_posts
Posts made through easyCoexistence, posted now or scheduled: upcoming ones soonest first, or by status, or one post by post_id. Each has its status (scheduled, publishing, processing, published, failed, canceled), publish_at, its link once live, the error if it failed, may_be_published when the network may have received it before failing, and deleted_on_network_at when Instagram or Facebook no longer has a published one.
update_scheduled_post
Move a scheduled post (scheduled_at) or change its text, while it is still scheduled. To change the media, cancel it and schedule a new one.
cancel_scheduled_post
Cancel a scheduled post so it never goes out (confirm with the user first).
retry_scheduled_post
Publish a failed post again, now. If it has may_be_published=true, look at the account first (list_social_posts) and pass confirm=true only if it is not there, or it goes out twice.

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.