Conecte su propio agente de IA o software a Tolk2Go
Qué puede conectar
- Otras herramientas de IA, como Microsoft Copilot, Gemini o Cursor.
- Creadores de agentes, como n8n o Zapier.
- Su propio chatbot o asistente.
- Su propio software, como un sistema de planificación o de gestión de casos, que reserve intérpretes directamente a través de API de Tolk2Go, sin necesidad de una IA.
Las herramientas de IA se conectan al servidor MCP de Tolk2Go (Model Context Protocol a través de HTTP transmisible). Su propio software utiliza la REST API, descrita en un contrato OpenAPI. La búsqueda de idiomas, especialidades e intérpretes disponibles es pública y no requiere iniciar sesión. Las reservas siempre se realizan en nombre de una cuenta de cliente de Tolk2Go.
Iniciar sesión con OAuth
Para clientes MCP compatibles con el inicio de sesión mediante OAuth. No se necesita ninguna clave.
- Añada el servidor MCP
https://api.tolk2go.com/api/v1/mcpal cliente. - Inicie sesión y autorice. El cliente abre una página de Tolk2Go. El usuario inicia sesión con su cuenta de cliente de Tolk2Go y selecciona «Permitir acceso». La contraseña permanece en Tolk2Go.
- Desconecte en cualquier momento en Acceso de agentes de IA dentro de la cuenta.
Tolk2Go es compatible con OAuth 2.1 con PKCE y registro dinámico de clientes. Los metadatos del servidor de autorización se encuentran en https://api.tolk2go.com/.well-known/oauth-authorization-server.
Conectar con una clave de agente
Para clientes que no admiten OAuth y para su propio software en la REST API.
- Utilice la cuenta de Tolk2Go a la que pertenecen las reservas. ¿Es nuevo? Cree una cuenta primero.
- Cree una clave de agente. Inicie sesión y abra Acceso de agentes de IA en la cuenta, elija «Crear clave» y cópiela. Solo se muestra una vez: guárdela en los ajustes secretos del cliente, nunca en un chat ni en una instrucción.
- Conecte el cliente al servidor MCP de Tolk2Go con la clave (véase el ejemplo de configuración más abajo) o facilítele el contrato OpenAPI. Un cliente también puede emitir una clave por sí mismo tras iniciar sesión una vez a través de la API.
- Sustituya o revoque la clave en cualquier momento en Acceso de agentes de IA. Una clave revocada deja de funcionar de inmediato.
Direcciones
| Qué | Dirección |
|---|---|
| Servidor MCP (HTTP transmisible) | https://api.tolk2go.com/api/v1/mcp |
| Contrato OpenAPI | https://api.tolk2go.com/api/v1/spec |
| Guía para agentes de IA | https://www.tolk2go.com/llms.txt |
| Habilidad del agente y ejemplos de configuración | github.com/Tolk2Go-Organization/agent-skills |
Ejemplo de configuración de cliente MCP con una clave de agente:
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
¿Desea disponer de todo el proceso de reserva en su agente de una sola vez? Instale la habilidad de agente de Tolk2Go con npx skills add Tolk2Go-Organization/agent-skills.
Seguridad
- Solo una cuenta. Una aplicación conectada o una clave de agente solo puede ver y gestionar las reservas de la cuenta que la conectó.
- Se muestra una sola vez, se almacena de forma segura. La clave de agente solo se muestra cuando se emite. Tolk2Go solo almacena un hash seguro, nunca la clave en sí.
- Duración limitada. Las claves son válidas durante 90 días por defecto (se pueden elegir de 7 a 365 días), por lo que un agente puede regresar semanas después sin tener que iniciar sesión de nuevo.
- Rote, revoque o desconecte en cualquier momento. En Acceso de agentes de IA, el cliente ve cada clave con su último uso y cada aplicación conectada, y puede sustituir o revocar una clave o desconectar una aplicación con un solo clic.
- Nunca se quedará sin acceso. ¿Ha perdido una clave? Revóquela en la cuenta y cree una nueva. El inicio de sesión habitual de la cuenta siempre sigue funcionando.
- Sin pagos por parte del agente. Cuando se requiera el pago por adelantado, el agente recibe un enlace de pago seguro para el cliente.
Preguntas frecuentes
¿Qué clientes son compatibles?
Cualquier asistente o agente compatible con Model Context Protocol (MCP) a través de Streamable HTTP, con inicio de sesión mediante OAuth o una clave de agente, y cualquier software que pueda invocar una REST API descrita en OpenAPI.
¿Qué ocurre si una clave de agente se pierde o se filtra?
Inicie sesión, revoque la clave en Acceso de agentes de IA dentro de la cuenta y cree una nueva. La clave revocada deja de funcionar, y solo podía acceder a las reservas de esa única cuenta.
¿Puede nuestro propio software hacer reservas sin un asistente de IA?
Sí. La REST API ofrece las mismas funciones de búsqueda, reserva y seguimiento que el servidor MCP. Consulte el contrato de OpenAPI más arriba.
¿Necesita ayuda con la conexión?
Estaremos encantados de ayudar a su departamento de TI o a su desarrollador a conectar Tolk2Go.