# Agentes de IA no hiClient

> Conecte Claude, Claude Code, ChatGPT ou outro cliente MCP à sua conta do hiClient com OAuth 2.1 e permissões que você escolhe.

Você pode conectar um assistente de IA à sua conta do hiClient para que ele consulte e faça o mesmo que você faz no portal: ofertas, reservas, formulários, site, mensagens, tickets, publicações, relatórios, equipamentos e perfil.

A conexão usa dois padrões abertos:

- **MCP** (Model Context Protocol): o assistente chama ferramentas do hiClient como `offers_list` ou `site_publish`.
- **OAuth 2.1**: você inicia sessão no hiClient e escolhe quais permissões concede. O assistente nunca vê a sua senha.

## Endereço do servidor {#server-url}

```
https://mcp.hi-client.com/mcp
```

É o único endereço de que você precisa. O assistente descobre sozinho como pedir autorização.

## Assistentes compatíveis {#clients}

| Assistente | Guia |
|---|---|
| Claude (web ou desktop) | [Conectar o Claude](https://docs.hi-client.com/agents/connect-claude.md?lang=pt) |
| Claude Code | [Conectar o Claude Code](https://docs.hi-client.com/agents/connect-claude-code.md?lang=pt) |
| ChatGPT | [Conectar o ChatGPT](https://docs.hi-client.com/agents/connect-chatgpt.md?lang=pt) |
| Outro cliente MCP | Qualquer cliente com transporte HTTP e OAuth 2.1 com PKCE. |

## Como funciona {#how-it-works}

1. Você adiciona o endereço do servidor no seu assistente.
2. O assistente abre o hiClient no navegador. Você inicia sessão; se a sua conta usa verificação em duas etapas, o código pode ser pedido.
3. Você vê qual assistente pede acesso e com quais permissões. Pode remover permissões antes de autorizar.
4. Você autoriza. A partir daí o assistente vê apenas as ferramentas das permissões concedidas.
5. A conexão permanece ativa até você revogá-la em [Agentes conectados](https://hi-client.com/account/portal/agents).

## O que um agente pode fazer {#can}

Com as permissões que você conceder, um agente pode, por exemplo:

- Listar ofertas, criar uma nova ou duplicar uma existente e publicá-la.
- Revisar reservas e o calendário do mês.
- Editar o rascunho do site, adicionar plugins, enviar imagens e publicar.
- Ler mensagens de visitantes, mudar o estado, etiquetá-las e cuidar de tickets de suporte.
- Consultar indicadores, vendas e pedidos.
- Renomear equipamentos e adicionar destinatários de alertas.
- Atualizar o perfil público, o idioma, o tema e o início do portal.

O detalhe está em [Permissões](https://docs.hi-client.com/agents/permissions.md?lang=pt) e em [Ferramentas](https://docs.hi-client.com/agents/tools.md?lang=pt).

## O que nunca pode fazer {#cannot}

Nenhuma permissão concede estas operações. Nenhum agente pode pedi-las:

- Mudar o plano, contratar, pagar ou cobrar. Nem movimentar dinheiro ou configurar meios de cobrança.
- Administrar domínios.
- Mexer na segurança da conta: senha, verificação em duas etapas, sessões, e-mail da conta.
- Exportar ou apagar a conta.
- Ver dados de pessoas: nomes ou contatos de quem reserva ou compra, fichas, rostos ou biometria. O servidor do hiClient não guarda fichas nem biometria, e as reservas são entregues sem a identidade de quem reservou.

## Um agente adiciona proteções, nunca as reduz {#portal-only}

Algumas ações existem no portal, mas nenhuma permissão as concede a um agente, porque desligariam uma proteção ou apagariam evidências. Se um agente tentar, recebe o erro `portal_only` e você as faz no portal:

- Pausar o canal de e-mail de alertas.
- Remover um destinatário de alertas já verificado.
- Desativar ou reduzir os canais do aviso de mudanças de segurança.
- Mudar a opção de exclusão biométrica ao desvincular.
- Apagar mensagens da caixa de entrada (o agente pode fechar a conversa).
- Apagar o site.
- Revogar um equipamento ou escolher qual equipamento mantém um assento: o portal pede um acesso recente, que um agente não pode dar.

O inverso é permitido: um agente pode retomar alertas, adicionar destinatários ou ampliar avisos. Quando um agente ativa um novo destinatário de alertas, você recebe um aviso de mudança de segurança que o agente não pode desligar.

## Próximos passos {#next}

- Conecte o seu assistente: [Claude](https://docs.hi-client.com/agents/connect-claude.md?lang=pt), [Claude Code](https://docs.hi-client.com/agents/connect-claude-code.md?lang=pt) ou [ChatGPT](https://docs.hi-client.com/agents/connect-chatgpt.md?lang=pt).
- Revise quais permissões conceder: [Permissões](https://docs.hi-client.com/agents/permissions.md?lang=pt).
- Leia as [boas práticas de segurança](https://docs.hi-client.com/agents/security.md?lang=pt).
