<link rel="stylesheet" href="assets/fontawesome/css/all.min.css" />

Ligue o seu próprio agente de IA ou software à Tolk2Go

Em resumo: Esta página destina-se a departamentos de TI e programadores. Explica como ligar uma ferramenta de IA que não seja o ChatGPT ou o Claude, ou o seu próprio software, a uma conta de cliente da Tolk2Go, para que possa pesquisar, reservar e acompanhar intérpretes. Utiliza o ChatGPT ou o Claude? Siga os passos simples em Acesso de agentes de IA na sua conta e consulte Reservar intérpretes com o seu agente de IA para saber o que o seu assistente pode fazer.

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.

  1. Adicione o servidor MCP https://api.tolk2go.com/api/v1/mcp ao cliente.
  2. 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.
  3. 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.

  1. Utilize a conta da Tolk2Go à qual pertencem as reservas. É novo por aqui? Crie uma conta primeiro.
  2. 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.
  3. 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.
  4. 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.