Collega il tuo agente IA o software a Tolk2Go
Cosa puoi collegare
- Altri strumenti di IA, come Microsoft Copilot, Gemini o Cursor.
- Piattaforme di creazione di agenti, come n8n o Zapier.
- Il tuo chatbot o assistente.
- Il tuo software proprietario, come un sistema di pianificazione o di gestione pratiche, che prenota interpreti direttamente tramite l’API di Tolk2Go, senza un’IA.
Gli strumenti di IA si collegano al server MCP di Tolk2Go (Model Context Protocol su HTTP in streaming). Il tuo software utilizza l’REST API, descritta in un contratto OpenAPI. La ricerca di lingue, specializzazioni e interpreti disponibili è pubblica e non richiede l’accesso. La prenotazione avviene sempre per conto di un unico account cliente Tolk2Go.
Accedi con OAuth
Per i client MCP che supportano l’accesso con OAuth. Non è necessaria alcuna chiave.
- Aggiungi il server MCP
https://api.tolk2go.com/api/v1/mcpal client. - Accedi e consenti. Il client apre una pagina di Tolk2Go. L’utente accede con il proprio account cliente Tolk2Go e sceglie Consenti l’accesso. La password rimane a Tolk2Go.
- Disconnetti in qualsiasi momento alla voce Accesso agente IA nell’account.
Tolk2Go supporta OAuth 2.1 con PKCE e la registrazione dinamica dei client. I metadati del server di autorizzazione sono disponibili all’indirizzo https://api.tolk2go.com/.well-known/oauth-authorization-server.
Collegati con una chiave agente
Per i client senza supporto a OAuth e per il tuo software sull’REST API.
- Usa l’account Tolk2Go a cui appartengono le prenotazioni. Sei un nuovo utente? Crea un account prima di tutto.
- Crea una chiave agente. Accedi e apri Accesso agente IA nell’account, scegli Crea chiave e copia la chiave. Viene mostrata una sola volta: conservala nelle impostazioni segrete del client, mai in una chat o in un prompt.
- Collega il client al server MCP di Tolk2Go con la chiave (esempio di configurazione più sotto), oppure forniscigli il contratto OpenAPI. Un client può anche generare autonomamente una chiave dopo aver effettuato una volta l’accesso tramite l’API.
- Sostituisci o revoca la chiave in qualsiasi momento alla voce Accesso agente IA. Una chiave revocata smette immediatamente di funzionare.
Indirizzi
| Elemento | Indirizzo |
|---|---|
| Server MCP (HTTP in streaming) | https://api.tolk2go.com/api/v1/mcp |
| Contratto OpenAPI | https://api.tolk2go.com/api/v1/spec |
| Guida per agenti IA | https://www.tolk2go.com/llms.txt |
| Competenza dell’agente ed esempi di configurazione | github.com/Tolk2Go-Organization/agent-skills |
Esempio di configurazione del client MCP con una chiave agente:
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
Vuoi subito l’intero percorso di prenotazione nel tuo agente? Installa la competenza dell’agente Tolk2Go con npx skills add Tolk2Go-Organization/agent-skills.
Sicurezza
- Un solo account. Un’app collegata o una chiave dell’agente può visualizzare e gestire solo le prenotazioni dell’account a cui è stata collegata.
- Mostrata una sola volta, archiviata in modo sicuro. Una chiave dell’agente viene mostrata solo al momento della generazione. Tolk2Go memorizza esclusivamente un hash sicuro, mai la chiave stessa.
- Durata limitata. Le chiavi sono valide per 90 giorni per impostazione predefinita (è possibile scegliere da 7 a 365 giorni), così un agente può tornare attivo settimane dopo senza dover ripetere l’accesso.
- Ruota, revoca o disconnetti in qualsiasi momento. Nella sezione relativa all’accesso per agenti IA, il cliente vede ogni chiave con l’ultimo utilizzo e ogni app collegata, e può sostituire o revocare una chiave o disconnettere un’app con un solo clic.
- Nessun rischio di rimanere bloccati fuori. Hai perso una chiave? Revocala nell’account e creane una nuova. Il normale accesso all’account continua sempre a funzionare.
- Nessun pagamento da parte dell’agente. Quando è richiesto il pagamento anticipato, l’agente riceve un link di pagamento sicuro per il cliente.
Domande frequenti
Quali applicazioni client sono supportate?
Qualsiasi assistente o agente che supporti il Model Context Protocol (MCP) tramite HTTP in streaming, con accesso OAuth o una chiave dell’agente, e qualsiasi software in grado di chiamare un’REST API descritta in OpenAPI.
Cosa succede se una chiave dell’agente viene smarrita o divulgata?
Accedi, revoca la chiave nella sezione relativa all’accesso per agenti IA del tuo account e creane una nuova. La chiave revocata smette di funzionare e avrebbe comunque potuto accedere solo alle prenotazioni di quell’unico account.
Il nostro software può prenotare senza un assistente IA?
Sì. L’REST API offre le stesse funzioni di ricerca, prenotazione e monitoraggio del server MCP. Consulta il contratto OpenAPI qui sopra.
Hai bisogno di aiuto per il collegamento?
Saremo lieti di aiutare il tuo reparto IT o il tuo sviluppatore a collegare Tolk2Go.