Server MCP easyCoexistence: ogni strumento, per rete
Il server MCP easyCoexistence offre a Claude, ChatGPT e agli altri client MCP 72 strumenti su WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e altri canali: pubblicazione e pianificazione, commenti, DM, insight, regole da commento a DM, automazioni e qualsiasi altro endpoint dell'API ufficiale di ogni rete, dietro un unico connettore con accesso tramite OAuth.
Aggiungilo in Claude come connettore personalizzato o in ChatGPT come server MCP personalizzato, poi accedi: come aggiungere il connettore. Gli strumenti che una sessione vede seguono ciò che l'account ha collegato.
WhatsApp 12
Un numero collegato tramite Coexistence: stato, messaggi nella finestra di 24 ore, template e dove finiscono i suoi messaggi.
Server MCP WhatsApp per Claude, ChatGPT e Cursor
list_numbers- Elenca i numeri di telefono aziendali collegati dell'utente, con stato della connessione, valutazione della qualità e livello di messaggistica. Inizia da qui: gli altri strumenti richiedono un connection_id di questo elenco.
get_number_health- Quadro completo dello stato di salute di un numero: snapshot Meta in tempo reale (qualità, stato del collegamento Coexistence) più la cronologia recente del monitoraggio (webhook e controlli del poller).
get_api_credentials- Credenziali per integrare questo numero con un sistema esterno (n8n, CRM, codice personalizzato): URL base della Graph API, WABA ID, ID del numero di telefono e, quando disponibile, il token di accesso dell'utente. Servono per l'invio. Per ricevere, usa set_webhook_destination con un webhook generico (in n8n: il nodo Webhook, non WhatsApp Trigger); non c'è alcun app secret da recuperare, vedi get_docs «Securing the webhook».
send_message- Invia un messaggio di testo libero dal numero aziendale dell'utente tramite l'API ufficiale. Funziona solo entro una finestra di assistenza clienti: il destinatario deve aver scritto a questo numero nelle ultime 24 ore (queste risposte sono gratuite). Per avviare una conversazione con chi non ha ancora scritto, usa invece send_template con un template approvato.
list_templates- Elenca i template di messaggio dell'account WhatsApp Business di questo numero, con il loro stato di revisione. In coexistence, i template possono essere inviati SOLO tramite API: l'app del telefono non può inviarli.
create_template- Crea un template di messaggio e lo invia alla revisione di Meta (l'approvazione di solito richiede pochi minuti, fino a circa 24 ore). Categorie: UTILITY (transazionale), MARKETING (promozionale, richiede un metodo di pagamento sull'account WhatsApp Business dell'utente), AUTHENTICATION. I componenti seguono il formato template di Meta, ad esempio [{type:'BODY', text:'Ciao {{1}}, il tuo ordine è stato spedito.'}]. Le variabili sono {{1}}, {{2}}… e richiedono valori di esempio: {type:'BODY', text:'…', example:{body_text:[['Ana']]}}.
get_template_status- Verifica lo stato di revisione di un template in base al nome (APPROVED / PENDING / REJECTED).
send_template- Invia un messaggio template APPROVED. È così che avvii una conversazione con chi non ti ha ancora scritto. Gli invii di marketing vengono addebitati da Meta sul metodo di pagamento dell'account WhatsApp Business dell'utente (configurato in WhatsApp Manager: non possiamo aggiungere carte tramite API).
set_webhook_destination- Instrada i messaggi in arrivo su questo numero (e le copie dei messaggi inviati dall'app del telefono) direttamente da Meta al sistema dell'utente: easyCoexistence non memorizza né inoltra mai il contenuto. La destinazione deve essere un endpoint HTTPS che implementa l'handshake webhook di Meta: su GET con hub.mode=subscribe e hub.verify_token=<verify_token>, restituisci hub.challenge. Meta firma ogni POST (X-Hub-Signature-256) con l'app secret di easyCoexistence, che non viene mai condiviso: quindi la destinazione non può validare quell'header. Non abilitare la validazione della firma lì e usa un ricevitore webhook generico (in n8n il nodo Webhook semplice, non il nodo WhatsApp Trigger, che si aspetta una app Meta propria dell'utente). Autentica le consegne con un segreto lungo e casuale incluso in callback_url stesso (nel percorso o nella query string), che l'endpoint verifica ad ogni richiesta; get_docs, sezione «Securing the webhook», contiene i dettagli. Se salvato entro 24 ore dal collegamento del numero, riceve anche l'importazione una tantum dei contatti del numero da parte di Meta e fino a 6 mesi di chat (webhook della cronologia, completati quando metadata.progress è 100): impostalo subito dopo il collegamento se le chat passate sono importanti. Chiamalo con callback_url=null per reimpostare l'instradamento.
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- Come collegare un nuovo numero. L'onboarding richiede un browser (popup di Meta + scansione del codice QR), quindi questo restituisce l'URL della dashboard e i passaggi, oltre al punto da cui iniziare quando l'utente vuole che i propri clienti colleghino numeri dall'interno del suo software (la Partner API).
get_docs- La documentazione del prodotto easyCoexistence (markdown): cos'è Coexistence, come funziona il collegamento, le regole di idoneità dei numeri e i blocchi comuni dell'onboarding, le regole di invio (finestra di 24 ore, template), l'instradamento dei webhook, il monitoraggio e la regola dei 14 giorni, e la Partner API passo dopo passo (per un SaaS o un'agenzia che collega i numeri dei propri clienti). Usala per rispondere a qualsiasi domanda su come funziona easyCoexistence.
Instagram e Facebook 12
Post, commenti, risposte private, DM nella finestra di 24 ore, insight e regole da commento a DM, su account Instagram e Pagine Facebook.
Server MCP di Instagram per Claude e ChatGPT · Server MCP di Facebook per 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- Post recenti dell'account (media Instagram, post delle Pagine o video TikTok) con ID, didascalie e conteggi.
list_social_comments- Commenti di un singolo post (post_id da list_social_posts).
reply_to_comment- Rispondi pubblicamente a un commento, oppure, con private=true, invia al commentatore un DM (Meta consente una sola risposta privata per commento, entro 7 giorni dal commento).
hide_comment- Nascondi (o, con hide=false, mostra di nuovo) un commento sul post dell'account.
send_social_dm- Invia un DM (Instagram Direct o Messenger) a chi ha scritto all'account nelle ultime 24 ore. recipient_id è il suo ID dall'evento del messaggio (inoltrato alla destinazione webhook).
get_social_insights- Statistiche dell'account (predefinito) o di un singolo post (object_id). Esempio account Instagram: metrics ['reach','views','accounts_engaged','follows_and_unfollows'], period 'day', params {metric_type:'total_value'}. Esempio post: metrics ['reach','likes','comments','saved','shares','views'], senza period. Pagine: ad esempio ['page_impressions_unique','page_post_engagements'], period 'day'. Meta rinomina le metriche tra una versione e l'altra: se una viene rifiutata, l'errore elenca quelle valide. Account TikTok: ad esempio ['followers_count','video_views','likes'], una riga per giorno; un singolo video (object_id = il suo item_id): ad esempio ['video_views','likes','comments','shares'].
create_comment_rule- Commento-DM: quando qualcuno commenta i post dell'account (o solo post_id) con una delle parole chiave (vuoto = ogni commento), riceve automaticamente dm_text come DM, più public_reply sotto il suo commento se impostato. Funziona 24/7 su easyCoexistence, senza bisogno di un agente. TikTok non ha DM: per gli account TikTok passa solo public_reply. Conferma il testo con l'utente prima di crearla.
list_comment_rules- Le regole commento-a-DM dell'account, con il numero di commenti a cui ciascuna ha risposto.
update_comment_rule- Mette in pausa o riattiva una regola commento-a-DM (active), oppure la elimina (delete=true, dopo la conferma dell'utente).
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
Video e post con foto, il loro stato di pubblicazione e i commenti dell'account.
Server MCP TikTok per 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- Stato di un post TikTok avviato con publish_tiktok_post (share_id dal suo risultato).
delete_tiktok_comment- Elimina un commento su uno dei video dell'account TikTok (dopo la conferma dell'utente).
YouTube 6
Caricamenti con la pianificazione di YouTube, commenti e la loro moderazione, e YouTube Analytics.
upload_youtube_video- Carica un video sul canale YouTube collegato da un URL HTTPS pubblico. YouTube richiede made_for_kids. La privacy predefinita è privato. YouTube gestisce la pianificazione in modo nativo: passa publish_at (ISO 8601) e il video diventa pubblico a quel momento. Nota: finché il progetto Google di easyCoexistence non supera la verifica API di YouTube, YouTube mantiene privati i caricamenti via API.
list_youtube_videos- I caricamenti del canale, dal più recente, con privacy, visualizzazioni, mi piace e numero di commenti.
list_youtube_comments- Thread di commenti su un video (video_id) o su tutto il canale, dal più recente, con le risposte. moderation_status heldForReview o likelySpam elenca i commenti in attesa di revisione da parte del titolare.
reply_to_youtube_comment- Risponde pubblicamente a un commento di primo livello, come canale.
moderate_youtube_comment- Approva (published), trattiene (heldForReview) o nasconde (rejected) un commento sui video del canale. ban_author con rejected nasconde anche i futuri commenti di quella persona.
get_youtube_analytics- Analytics di YouTube per il canale o per un singolo video (video_id). Predefiniti: ultimi 28 giorni; visualizzazioni, tempo di visione, durata media di visione, mi piace, commenti, iscritti guadagnati e persi. dimensions, ad esempio 'day', 'video' (con sort '-views' e max_results), 'country'.
LinkedIn 7
Post come Pagina aziendale o come membro, commenti e statistiche della Pagina.
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- I post di una Pagina LinkedIn, dal più recente (solo account di Pagina: LinkedIn non consente alle app di elencare i post di un profilo personale). Per paginare usa start = next_start.
list_linkedin_comments- I commenti a un post LinkedIn (post_id), oppure le risposte a un commento (comment_urn). Gli autori sono restituiti come URN (urn:li:person:… o urn:li:organization:…).
comment_on_linkedin_post- Commenta un post come Pagina o come membro, oppure risponde a un commento passando parent_comment_urn. Concorda prima il testo con l'utente.
delete_linkedin_comment- Elimina un commento. Una Pagina può rimuovere qualsiasi commento sui propri post (LinkedIn non ha la funzione di nascondere); un profilo solo i propri commenti. Operazione irreversibile: chiedi conferma all'utente.
delete_linkedin_post- Elimina un post pubblicato dall'account. Operazione irreversibile: chiedi conferma all'utente.
get_linkedin_stats- Analytics LinkedIn. Account di Pagina: numero di follower più impression, impression uniche, clic, mi piace, commenti, condivisioni e tasso di coinvolgimento, complessivi oppure per DAY/MONTH tra since e until, facoltativamente per un solo post_id. Account di profilo: reazioni e numero di commenti per un post_id.
Automazioni 19
Risposte automatiche con testo fisso o con IA, su numeri, Instagram, Facebook e TikTok.
set_inbound_mode- Come fluiscono i messaggi in arrivo di un numero. "managed": Meta li consegna a easyCoexistence, le automazioni possono rispondere e possono essere inoltrati a forward_url firmati con un segreto che solo l'utente possiede (X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 di "<t>.<body>">); il segreto viene restituito una sola volta. Attivare managed rimuove una destinazione webhook diretta. "direct": Meta consegna direttamente alla destinazione impostata con set_webhook_destination, easyCoexistence non vede mai i messaggi e le automazioni si fermano. Passa solo forward_url per cambiare l'inoltro su un numero managed, null per interromperlo.
list_automations- Le automazioni dell'account (facoltativamente per un solo numero), con trigger, passaggi e stato, più i provider di IA per cui è salvata una chiave. Un numero deve essere managed (set_inbound_mode) perché le sue automazioni vengano eseguite.
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- Modifica un'automazione. I campi omessi mantengono il valore attuale; i passaggi, se forniti, sostituiscono l'intero elenco. connection_id la sposta su un altro numero o su un canale Instagram, Facebook o TikTok (trigger e passaggi devono essere compatibili con quel canale).
delete_automation- Elimina un'automazione e la sua cronologia delle esecuzioni.
test_automation- Esegue i passaggi di un'automazione su un messaggio di esempio senza inviare nulla a nessuno. Il passaggio IA e il webhook vengono eseguiti davvero, quindi il risultato mostra la risposta effettiva. Restituisce l'esecuzione con l'output di ogni passaggio.
list_automation_runs- Le esecuzioni recenti di un'automazione (ultimi 30 giorni), dalla più recente: stato (done, failed, skipped, waiting), skip_reason (human_active = il titolare ha risposto di recente dal telefono, window_closed = sono passate più di 24 h dall'ultimo messaggio del cliente, ai_limit, superseded), output ed errore di ogni passaggio e token IA utilizzati.
get_automation_run- Una singola esecuzione con input, output, errore e tempi di ogni passaggio.
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.
Configurazione della Partner API 5
Per il software che collega i propri clienti: la chiave, l'URL degli eventi e i link di connessione ospitati.
get_partner_setup- Stato della configurazione della Partner API, per un utente il cui software o la cui piattaforma per agenzie permette ai PROPRI clienti di collegare numeri (link di connessione ospitati): se la fatturazione è pronta, se esiste una chiave API, dove vengono inviati gli eventi di stato e il passo successivo. Chiamalo per primo quando l'utente vuole configurarla, poi guidalo con create_api_key, set_partner_events_url e create_connect_link.
create_api_key- Crea la chiave Partner API dell'account (ec_live_…) e la restituisce UNA sola volta. L'utente deve conservarla come segreto lato server. Una chiave per account: se ne esiste già una, l'operazione viene rifiutata a meno che replace_existing=true, perché la sostituzione revoca immediatamente la vecchia chiave. Passa replace_existing=true solo dopo che l'utente ha confermato esplicitamente.
revoke_api_key- Revoca la chiave Partner API dell'account (per una chiave compromessa o per interrompere l'integrazione). Ogni richiesta che la usa fallirà da quel momento. Richiede confirm=true, solo dopo che l'utente lo ha chiesto esplicitamente.
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- Crea un link di connessione ospitato (una sessione di connessione della Partner API) per uno dei clienti dell'utente, come POST /api/v1/connect-sessions: restituisce un URL su easycoexistence.com da inviare al cliente, valido 1 ora. Il cliente esegue lì il popup di Meta e viene reindirizzato a redirect_url. Il numero risultante appartiene a questo account e viene fatturato a questo account. Usalo per testare una configurazione della Partner API o per fare l'onboarding di un cliente manualmente.
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Domande frequenti
Quanti strumenti ha il server MCP easyCoexistence?
72 oggi, elencati in questa pagina per rete e letti dalle definizioni stesse del server, quindi l'elenco è sempre aggiornato.
Un solo connettore copre tutte le reti?
Sì. Aggiungi https://easycoexistence.com/api/mcp una volta e accedi; gli strumenti raggiungono ogni numero e account collegato al tuo account easyCoexistence.
L'assistente può chiamare un endpoint che nessuno strumento copre?
Su TikTok, dal tuo codice: get_social_credentials gli consegna il token dell'account per qualsiasi endpoint dell'API for Business di TikTok. Su Instagram e Facebook no: i loro token restano presso easyCoexistence, quindi l'assistente lavora tramite gli strumenti dedicati.
Quanto costa?
Il connettore è incluso. Le connessioni costano da US$ 9 fino a US$ 0.75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, uguale su ogni rete, con i primi 3 giorni gratuiti.