Ligue o seu próprio agente de IA ou software à Tolk2Go
O que pode ligar
- Outras ferramentas de IA, como o Microsoft Copilot, o Gemini ou o Cursor.
- Plataformas de criação de agentes, como o n8n ou o Zapier.
- O seu próprio chatbot ou assistente.
- O seu próprio software, como um sistema de planeamento ou de gestão de processos, que reserva intérpretes diretamente através da API da Tolk2Go, sem uma IA.
As ferramentas de IA ligam-se ao servidor MCP da Tolk2Go (Model Context Protocol sobre Streamable HTTP). O seu próprio software utiliza a REST API, descrita num contrato OpenAPI. A pesquisa de línguas, especializações e intérpretes disponíveis é pública e não requer início de sessão. A reserva é sempre efetuada em nome de uma conta de cliente da Tolk2Go.
Iniciar sessão com OAuth
Para clientes MCP que suportam o início de sessão OAuth. Não é necessária nenhuma chave.
- Adicione o servidor MCP
https://api.tolk2go.com/api/v1/mcpao cliente. - Inicie sessão e permita o acesso. O cliente abre uma página da Tolk2Go. O utilizador inicia sessão com a sua conta de cliente da Tolk2Go e escolhe Permitir acesso. A palavra-passe permanece na Tolk2Go.
- Desligue em qualquer momento em Acesso de agentes de IA na conta.
A Tolk2Go suporta OAuth 2.1 com PKCE e registo dinâmico de clientes. Os metadados do servidor de autorização encontram-se em https://api.tolk2go.com/.well-known/oauth-authorization-server.
Ligar com uma chave de agente
Para clientes sem suporte para OAuth e para o seu próprio software na REST API.
- Utilize a conta da Tolk2Go à qual pertencem as reservas. É novo por aqui? Crie uma conta primeiro.
- Crie uma chave de agente. Inicie sessão e abra Acesso de agentes de IA na conta, escolha Criar chave e copie a chave. Esta só é mostrada uma vez: guarde-a nas definições secretas do cliente, nunca num chat ou prompt.
- Ligue o cliente ao servidor MCP da Tolk2Go com a chave (exemplo de configuração abaixo) ou forneça-lhe o contrato OpenAPI. Um cliente também pode emitir uma chave por si próprio após iniciar sessão uma vez através da API.
- Substitua ou revogue a chave em qualquer momento em Acesso de agentes de IA. Uma chave revogada deixa de funcionar imediatamente.
Endereços
| O quê | Endereço |
|---|---|
| Servidor MCP (Streamable HTTP) | https://api.tolk2go.com/api/v1/mcp |
| Contrato OpenAPI | https://api.tolk2go.com/api/v1/spec |
| Guia para agentes de IA | https://www.tolk2go.com/llms.txt |
| Competência de agente e exemplos de configuração | github.com/Tolk2Go-Organization/agent-skills |
Exemplo de configuração de cliente MCP com uma chave de agente:
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
Quer ter todo o processo de reserva no seu agente de uma só vez? Instale a competência de agente da Tolk2Go com npx skills add Tolk2Go-Organization/agent-skills.
Segurança
- Apenas uma conta. Uma aplicação conectada ou uma chave de agente só pode ver e gerir as reservas da conta que a conectou.
- Apresentada uma vez, armazenada em segurança. Uma chave de agente é apresentada apenas quando é emitida. A Tolk2Go armazena apenas um hash seguro, nunca a própria chave.
- Validade limitada. As chaves são válidas por 90 dias por predefinição (é possível escolher entre 7 e 365 dias), para que um agente possa regressar semanas mais tarde sem iniciar sessão novamente.
- Renove, revogue ou desconecte a qualquer momento. Em Acesso de agente de IA, o cliente vê cada chave com a sua última utilização e cada aplicação conectada, e substitui ou revoga uma chave ou desconecta uma aplicação com um clique.
- Sem risco de bloqueio. Perdeu uma chave? Revogue-a na conta e crie uma nova. O início de sessão normal na conta continua sempre a funcionar.
- Sem pagamentos pelo agente. Quando for exigido pagamento antecipado, o agente obtém uma ligação de pagamento segura para o cliente.
Perguntas frequentes
Que clientes são suportados?
Qualquer assistente ou agente que suporte o Model Context Protocol (MCP) através de Streamable HTTP, com início de sessão por OAuth ou uma chave de agente, e qualquer software que possa chamar uma REST API descrita em OpenAPI.
O que acontece se uma chave de agente for perdida ou divulgada?
Inicie sessão, revogue a chave em Acesso de agente de IA na conta e crie uma nova. A chave revogada deixa de funcionar e só podia aceder às reservas dessa única conta.
O nosso próprio software pode reservar sem um assistente de IA?
Sim. A REST API oferece a mesma pesquisa, reserva e acompanhamento que o servidor MCP. Consulte o contrato OpenAPI acima.
Precisa de ajuda para conectar?
Teremos todo o gosto em ajudar o seu departamento de TI ou programador a conectar a Tolk2Go.