Conectar seu assistente

Conecte seu assistente ao TunnelHub pela URL abaixo. Você faz login pelo navegador e autoriza o assistente a usar as ferramentas disponíveis para sua conta.

https://mcp.tunnelhub.io/tunnelhub/mcp

Essa URL é a mesma para todas as empresas e ambientes. Você escolhe onde trabalhar depois de conectar.

Antes de começar

Você precisa de uma conta TunnelHub com acesso à empresa e ao ambiente desejados, além de um cliente com suporte a MCP remoto, transporte Streamable HTTP e autenticação OAuth.

Conectar e autorizar

1. Adicione o TunnelHub como servidor MCP remoto no seu cliente, usando a URL acima.
2. Inicie a autenticação e faça login no TunnelHub pelo navegador.
3. Confira a solicitação de acesso e autorize a conexão.
4. Retorne ao assistente e peça: “Liste minhas empresas e os ambientes disponíveis”.

A autorização mantém as permissões da sua conta. Ela não libera acesso a empresas, ambientes ou operações que você não pode usar no TunnelHub.

OpenCode

Adicione o servidor ao arquivo de configuração do OpenCode:

{
  "mcp": {
    "tunnelhub": {
      "type": "remote",
      "url": "https://mcp.tunnelhub.io/tunnelhub/mcp"
    }
  }
}

Em seguida, execute e conclua a autorização no navegador:

opencode mcp auth tunnelhub

Consulte também o guia de servidores MCP do OpenCode.

Codex

No Codex CLI, execute:

codex mcp add tunnelhub --url https://mcp.tunnelhub.io/tunnelhub/mcp
codex mcp login tunnelhub

No aplicativo Codex, abra as configurações de servidores MCP, adicione um servidor Streamable HTTP com o nome tunnelhub e a URL acima, salve e autorize a conexão.

Consulte também o guia de MCP do Codex.

Claude Code

Adicione o servidor:

claude mcp add --transport http tunnelhub https://mcp.tunnelhub.io/tunnelhub/mcp

No Claude Code, use /mcp, selecione o TunnelHub e inicie a autenticação. Veja o guia de MCP do Claude Code para as opções do cliente.

Claude

Na área de conectores, adicione um conector personalizado com a URL do TunnelHub e conclua o login. Em contas de equipe, um administrador pode precisar disponibilizar o conector antes de cada pessoa conectar sua conta.

Consulte o guia de conectores personalizados do Claude.

ChatGPT

Habilite o modo de desenvolvedor, quando disponível, e adicione uma conexão MCP personalizada na área de aplicativos ou plugins. Informe a URL do TunnelHub, selecione autenticação OAuth e conclua o login. Depois, habilite a conexão na conversa em que deseja usá-la.

A disponibilidade desse recurso depende da conta e das políticas da sua organização. Consulte o guia de conexão MCP do ChatGPT.

Escolher a empresa e o ambiente

Informe ao assistente em qual empresa e ambiente deseja trabalhar. Ele pode descobrir os identificadores pelas ferramentas:

1. list_my_tenants_tunnelhub: lista as empresas acessíveis.
2. list_environments_tunnelhub: recebe o tenantId da empresa e lista seus ambientes.
3. As operações seguintes recebem tenantId e, quando se referem a um ambiente, environmentId.

Por exemplo, uma chamada a list_automations_tunnelhub usa:

{
  "tenantId": "<id-da-empresa>",
  "environmentId": "<id-do-ambiente>",
  "current": 1,
  "pageSize": 20
}

Os IDs devem ser os retornados pelas ferramentas. Cada operação identifica a empresa e o ambiente em que será realizada.

Resolver problemas de conexão

Situação	O que fazer
A autorização expirou ou o login não foi concluído	Inicie novamente a autenticação pelo cliente e conclua o fluxo no navegador.
Uma empresa ou um ambiente não aparece	Confira a conta usada no login e peça ao administrador para verificar seu acesso.
Uma operação foi negada	Confira a empresa, o ambiente e as permissões necessárias para a operação.
Sua empresa exige login corporativo por SAML	Essa forma de autenticação ainda não está disponível nesta conexão. Consulte o administrador para orientação sobre o acesso.

Para encerrar o uso, desconecte o TunnelHub nas configurações do cliente.

Continue em Catálogo de ferramentas ou Investigando execuções.