# 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.

```text
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:

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

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

```bash
opencode mcp auth tunnelhub
```

Consulte também o [guia de servidores MCP do OpenCode](https://opencode.ai/docs/mcp-servers/).

### Codex

No Codex CLI, execute:

```bash
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](https://developers.openai.com/codex/mcp).

### Claude Code

Adicione o servidor:

```bash
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](https://code.claude.com/docs/en/mcp) 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](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

### 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](https://developers.openai.com/plugins/deploy/connect-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:

```json
{
  "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](/mcp/tools.md) ou [Investigando execuções](/mcp/investigating-executions.md).