# Use o KolHive e o KolWrite a partir da sua app de IA

A sua própria app de IA pode trabalhar na app de computador KolHive, KolWrite ou KolChat no seu computador: Claude Code, Codex, Cursor, Gemini CLI, VS Code e qualquer app que suporte MCP por HTTP. Você aprova cada app uma vez e escolhe o quanto ela pode fazer.

Usar a sua app de IA com o KolHive ou o KolWrite exige o plano Plus ou superior.

## 1. Ative

Abra a app de computador e desbloqueie-a. Vá a Definições → IA → Apps de IA neste computador, ative a opção e pressione Conectar uma app. Escolha a sua app, leia qual empresa de IA recebe o que ela lê, escolha o quanto ela pode fazer e pressione Conectar. Cada app recebe a sua própria chave, mostrada uma única vez.

## 2. Conecte a sua app

Cursor e VS Code: pressione Adicionar ao Cursor ou Adicionar ao VS Code no passo de configuração. A app abre e pede que você confirme.

Claude Code (no KolWrite o nome é `kolwrite` em vez de `kolhive`):

```bash
claude mcp add --scope user --transport http kolhive http://127.0.0.1:47321/mcp --header "Authorization: Bearer khc_..."
```

Não disponível através desta ligação: Claude Desktop e outras apps que só iniciam programas locais, e as apps web. Para ChatGPT, Claude.ai e telemóveis, veja o passo 5.

Qualquer outra app MCP: use o endereço e o cabeçalho que o passo de configuração mostra.

```text
URL: http://127.0.0.1:47321/mcp
Header: Authorization: Bearer khc_...
```

## 3. O que a sua app de IA pode fazer

- KolHive: ficheiros, documentos e folhas de cálculo, notas, tarefas e calendário, o editor de vídeo, transcrições, partilha, apps e criação de apps.
- KolWrite: ficheiros, notas e calendário, transcrições e partilha. Sem criação de apps e sem KOL Store.
- KolChat: apenas os seus créditos e o seu armazenamento. As apps de IA não podem ler as suas mensagens.
- Iniciar uma transcrição na nuvem gasta os seus créditos. A app pergunta sempre, a menos que você lhe tenha dado controlo total e permitido gastos.

## 4. Seguro por conceção

- Ouve apenas em `127.0.0.1`, este computador, por isso o Windows não pergunta sobre a sua firewall.
- Antes de uma app se conectar, a app de computador nomeia a empresa de IA que recebe o que a app lê, segundo os termos dessa empresa, e espera pelo seu OK.
- Perguntar antes de apagar, partilhar ou gastar (predefinição): a app lê, edita e constrói sem perguntar, e pergunta sempre antes de apagar, partilhar ou enviar, publicar ou gastar créditos. Controlo total, nunca perguntar: sem perguntas, exceto antes de gastar, a menos que você permita. Nada é memorizado entre perguntas.
- Cada app tem a sua própria chave, e o KolHive e o KolWrite guardam apenas uma impressão digital dela. Remova uma app e o acesso dela termina de imediato.
- A app de computador tem de estar aberta e desbloqueada. Terminar sessão remove todas as apps.
- As definições mostram o que cada app fez, nunca o que leu.
- O que a sua app de IA lê vai para a sua própria empresa de IA. Nada mais sai do seu computador por esta ligação.

## 5. ChatGPT, Claude.ai e telemóveis

Estas apps não alcançam o seu computador, por isso usam o conector online: adicione o KolHive ou o KolWrite uma vez na app de IA, inicie sessão e escolha o que ela pode fazer. Funciona a partir de qualquer dispositivo, com a app de computador fechada, para ficheiros, transcrição (com os seus próprios créditos e o preço mostrado primeiro) e ligações de partilha. Os documentos, as notas e o calendário ficam no seu computador. Se já está aberto, e o endereço a adicionar: [Guia do KolHive](https://www.kolhive.com/en/chatgpt-claude-connector/).

## 6. Um guia curto por app

No KolHive ou no KolWrite, abra ChatGPT e Claude no menu e escolha o seu app: ele mostra estes mesmos passos. Os passos online funcionam quando o conector online estiver aberto (situação no guia do KolHive acima). No desktop você pode escolher This computer, que funciona offline enquanto o app estiver aberto (passos 1 a 4).

- **ChatGPT**: copie o seu endereço no app. Em chatgpt.com, abra Plugins → + → Add custom MCP server, cole, entre e toque em Permitir. O que dá para adicionar é regra do ChatGPT, não nossa; em novembro de 2026, Business e Enterprise/Edu podem ler e escrever, Pro pode ler, e o plano gratuito não pode adicionar servidor personalizado, então veja a ajuda do ChatGPT. O app do ChatGPT no celular passa a usá-lo.
- **Claude**: copie o seu endereço no app. Em claude.ai ou no Claude Desktop, abra Customize → Connectors → + Add → Add custom connector, cole, entre e toque em Permitir. Todos os planos do Claude aceitam um conector personalizado; o gratuito, um. Os apps do Claude no celular usam os conectores adicionados na web.
- **Cursor e VS Code**: toque em Add to Cursor ou Add to VS Code. O app abre e pede confirmação; depois entre e toque em Permitir. No VS Code também dá para usar Command Palette → MCP: Add Server → HTTP.
- **Claude Code**: copie do app o comando de uma linha, execute no terminal, digite `/mcp` no Claude Code, entre e toque em Permitir.
- **Codex e Gemini CLI**: copie do app o comando de uma linha, execute no terminal, depois entre e toque em Permitir.
- **Qualquer outro app de IA**: adicione um servidor MCP remoto (HTTP) com o endereço que o app mostra, entre e toque em Permitir.
