Integrazione MCP

Il tuo Agendly, dentro
il tuo agente AI.

Porta agenti, campagne e appuntamenti nel tuo ambiente AI. Collega ChatGPT con il tuo account Agendly tramite OAuth, oppure usa la chiave API con Codex, Claude Code e altri agenti MCP compatibili.

Streamable HTTP · API key · MCP

● ● ●agendly / mcp

Il tuo agente AI

ChatGPT, Codex, Claude Code e altri client MCP

AgendlyModel Context Protocol

Mostrami gli appuntamenti di domani.

Leggere e analizzarePreparare modificheContinuare nella dashboard

01 / LE POSSIBILITÀ

Cosa puoi fare

Descrivi quello che ti serve. Il client usa gli strumenti Agendly per leggere i dati del tuo account o preparare una modifica da verificare.

Leggere e analizzare

Consulta campagne, storico chiamate, contatti e appuntamenti. Chiedi totali, elenchi e report per periodo.

Preparare modifiche

Crea o aggiorna agenti, campagne, servizi per appuntamenti e altre risorse supportate tramite proposta e approvazione.

Continuare nella dashboard

Usa i link alla dashboard per pagamenti, collegamento degli account, caricamento di file e altri passaggi che richiedono il sito.

02 / IL COLLEGAMENTO

Dalla chiave alla prima richiesta.

Scegli il collegamento OAuth o la configurazione con chiave API per il tuo client.

OAuth

Collega ChatGPT con OAuth

Accedi con il tuo account Agendly e autorizza i permessi: non serve copiare una chiave API.

L’aggiunta di server MCP personalizzati dipende dalle funzionalità del tuo account e dalle impostazioni del workspace ChatGPT.

Aggiungi un server MCP personalizzato in ChatGPT.
Inserisci https://api.agendly.ai/mcp come URL del server e scegli OAuth.
Avvia il collegamento, accedi ad Agendly e controlla i permessi richiesti.
Autorizza il collegamento, torna a ChatGPT e prova una delle richieste qui sotto.

Client con chiave API

Accedi ad Agendly, apri Integrazioni → Integrazione API e crea una chiave per questo collegamento. La chiave dà accesso al tuo account.

Apri Integrazione API

Endpoint Streamable HTTP

https://api.agendly.ai/mcp

Negli esempi la chiave viene letta dalla variabile di ambiente AGENDLY_API_KEY. Non inserire la chiave reale in file di configurazione condivisi o nelle conversazioni.

Configura il tuo agente

Per i client con chiave API, aggiungi un server MCP remoto: usa l’endpoint qui sopra, seleziona Streamable HTTP e imposta l’header X-API-Key con la tua chiave Agendly. Per i client OAuth, usa lo stesso endpoint e autorizza l’accesso dal tuo account Agendly.

Usi Codex o Claude Code? Ecco le configurazioni pronte da copiare.

OPENAI

Codex

Aggiungi questa voce a ~/.codex/config.toml. Se il file contiene altri server MCP, conserva le voci esistenti. Codex legge l’header X-API-Key dalla variabile di ambiente.

~/.codex/config.toml

[mcp_servers.agendly]
url = "https://api.agendly.ai/mcp"
env_http_headers = { "X-API-Key" = "AGENDLY_API_KEY" }

Nel terminale da cui avvii Codex, imposta AGENDLY_API_KEY con la tua chiave Agendly e avvia una nuova sessione. Sostituisci il segnaposto prima di eseguire il comando.

Terminale · macOS / Linux

export AGENDLY_API_KEY="<YOUR_AGENDLY_API_KEY>"
codex

In Codex, apri /mcp e verifica che agendly sia collegato. Poi prova una delle richieste qui sotto. Riavvia Codex dopo aver modificato configurazione o variabile di ambiente.

Documentazione ufficiale MCP di Codex

✳

ANTHROPIC

Claude Code

Crea o aggiorna .mcp.json nella cartella del progetto con questa voce. Se mcpServers esiste già, aggiungi agendly al suo interno e conserva gli altri server. Il riferimento alla variabile permette a Claude Code di leggere la chiave dall’ambiente.

.mcp.json

{
  "mcpServers": {
    "agendly": {
      "type": "http",
      "url": "https://api.agendly.ai/mcp",
      "headers": {
        "X-API-Key": "${AGENDLY_API_KEY}"
      }
    }
  }
}

Imposta AGENDLY_API_KEY nel terminale prima di avviare Claude Code. Sostituisci il segnaposto con la tua chiave Agendly.

Terminale · macOS / Linux

export AGENDLY_API_KEY="<YOUR_AGENDLY_API_KEY>"
claude

Avvia Claude Code in quel progetto, approva la configurazione MCP del progetto quando richiesto e apri /mcp per verificare il collegamento. Queste istruzioni sono per Claude Code; gli altri client Claude possono richiedere modalità diverse.

Documentazione ufficiale MCP di Claude Code

03 / LA PRIMA CONVERSAZIONE

Prova queste richieste

Una domanda è tutto quello che serve per iniziare. Prova uno di questi esempi nel tuo client.

“Usa Agendly per elencare le mie campagne e il loro stato attuale.”

“Mostrami gli appuntamenti di domani.”

“Analizza le chiamate degli ultimi sette giorni.”

“Prepara un servizio di 30 minuti chiamato Consulenza e mostrami la proposta prima di applicarla.”

Verifica le modifiche prima di applicarle

Le letture possono essere eseguite subito. Per le modifiche, chiedi al client di mostrare la proposta completa, con i nuovi testi e i valori prima e dopo. Dopo la tua approvazione esplicita, applica la proposta salvata. Puoi anche chiedere di annullare una proposta in attesa.

Il client esterno è responsabile della richiesta di approvazione. Collega solo client a cui affideresti l’accesso al tuo account. Le proposte scadono e potrebbe essere necessario prepararle di nuovo.

DA SAPERE

Domande sul collegamento

Quali agenti AI posso collegare?

Puoi usare client MCP con Streamable HTTP e OAuth, come ChatGPT, oppure con l’header personalizzato X-API-Key, come Codex e Claude Code. Trovi entrambe le modalità in questa pagina. SSE legacy e stdio non sono supportati.

Perché ricevo un errore di autenticazione?

Verifica che la chiave API sia valida, non sia scaduta o revocata e sia disponibile nello stesso ambiente da cui avvii il client. Usa la chiave API Agendly, non un token della sessione dashboard o una chiave OpenAI/Anthropic.

Come rimuovo l’accesso?

Per OAuth, apri Integrazioni → Integrazione API e revoca l’applicazione collegata. Per le chiavi API, elimina o fai scadere la chiave nello stesso pannello. Poi rimuovi il collegamento dal client.