◆ Conectar a sua IA

Qual caminho é o seu?

Ache a sua ferramenta na primeira coluna e siga o link da segunda: cada caminho leva de um a cinco minutos. Pela ponte (Claude Code e Codex) o teste final é escrever mia prova no terminal; no navegador, no MCP e na API o teste é ver o texto já sem nomes na própria tela.

1 · Claude, ChatGPT e Gemini no navegador copiar e colar · todos os planos

Para quem usa a IA pela assinatura no navegador. Não há gancho programático nessas interfaces, então o caminho é o de três passos da página principal:

Siga os três passos numerados: anonimize, cole na IA, traga a resposta de volta para reverter. Cada ida e volta leva menos de um minuto.

1. Anonimize o texto ou o documento em privacy.wikimia.cloud e copie a versão limpa.
2. Cole na sua IA e faça o pedido normalmente — ela vai responder falando de [NOME_1], e está tudo bem.
3. Traga a resposta de volta para a aba Reverter: a troca pelos dados reais acontece no seu navegador. Nada disso passa pelo nosso servidor.

Uma extensão de navegador que limpa direto dentro do ChatGPT, Claude e Gemini ainda não existe. Quando existir, é aqui que vai aparecer. Preferimos dizer do que deixar você descobrir sozinho.

2 · Claude Code no terminal ponte · Pro

O terminal continua sendo o seu terminal, com a sua chave ou o seu login. Muda só para onde ele fala: em vez de ir direto ao provedor, cada mensagem passa pelo MIA, que troca nome, CPF, endereço, telefone e os demais dados por apelidos, repassa, e coloca os dados reais de volta na resposta — inclusive em streaming.

Escolha a aba do seu sistema, copie a linha e cole no terminal antes de abrir o Claude Code — leva menos de um minuto. Confirme com /status e com o mia prova, explicado no fim da seção.

Ligue com uma linha

$env:ANTHROPIC_BASE_URL="https://privacy.wikimia.cloud/p/SEU_TOKEN"; claude

ANTHROPIC_BASE_URL="https://privacy.wikimia.cloud/p/SEU_TOKEN" claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://privacy.wikimia.cloud/p/SEU_TOKEN"
  }
}

Como saber que está ligado

• Dentro do Claude Code, /status mostra o endereço da API em uso — tem que aparecer privacy.wikimia.cloud.
• Toda resposta que passa pela ponte traz o cabeçalho x-mia-anonimizados: N (quantos dados foram trocados naquela mensagem).
• A ponte está de pé? curl -s https://privacy.wikimia.cloud/ponte/saude responde {"ok": true, …}.

A sua credencial continua sua

Funciona com a sua chave de API (ANTHROPIC_API_KEY) e com o login da assinatura: o MIA só repassa a credencial ao provedor, não guarda. Se o login da assinatura reclamar em algum passo, use a chave de API.

Quer outro modelo na mesma ponte? (avançado)

A ponte fala o protocolo da Anthropic e pode entregar a DeepSeek, Kimi ou GLM — o Claude Code continua o mesmo, só o destino muda. Escolha com o cabeçalho x-mia-destino:

$env:ANTHROPIC_BASE_URL="https://privacy.wikimia.cloud/p/SEU_TOKEN"
$env:ANTHROPIC_CUSTOM_HEADERS="x-mia-destino: deepseek"   # ou kimi, glm, anthropic
$env:ANTHROPIC_AUTH_TOKEN="sua chave do provedor escolhido"
$env:ANTHROPIC_MODEL="deepseek-v4-pro"
claude

O seu token

O token no endereço é a sua credencial: quem tiver ele usa a sua ponte. Se vazar, troque — o endereço antigo para de funcionar na hora.

Neste modo o texto cru passa pela nossa caixa, em memória, sem ser gravado. É o único modo do produto em que isso acontece — e está no contrato. Se algum dado com formato conferível (CPF, CNPJ, processo…) escapar da anonimização, a ponte bloqueia o envio em vez de mandar.

Teste e guarde: mia prova e mia guarda

Com a ponte ligada, rode mia prova no terminal: ele mostra exatamente o que o provedor recebeu — já com apelidos no lugar dos dados. Ao fim da conversa, mia guarda resume o que aconteceu e grava no seu WikiSecret, na gaveta Conversas. Veja a prova da ponte.

O resumo gravado pelo mia guarda entra na busca do seu WikiSecret. Cada decisão, achado e erro vira uma nota própria e pesquisável — a IA encontra de novo aquilo que você já resolveu.

3 · Codex, da OpenAI provedor · Pro

O Codex fala o protocolo da OpenAI. Ele aponta para o MIA como um provedor; o resto é igual. Funciona com a sua chave da OpenAI e também com o login do ChatGPT.

Escolha a aba do seu caso, copie o trecho para o ~/.codex/config.toml e rode codex normalmente — leva uns dois minutos. Confirme com o mia prova, explicado no fim da seção.

No arquivo ~/.codex/config.toml

[model_providers.mia]
name = "MIA Privacy"
base_url = "https://privacy.wikimia.cloud/p/SEU_TOKEN/openai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

model_provider = "mia"

[model_providers.mia]
name = "MIA Privacy"
base_url = "https://privacy.wikimia.cloud/p/SEU_TOKEN/openai/v1"
wire_api = "responses"
requires_openai_auth = true
http_headers = { "x-mia-destino" = "chatgpt" }

model_provider = "mia"

Depois é só rodar codex normalmente. Cada pedido passa pelo MIA: nome, CPF, endereço e telefone viram apelidos antes de ir para a OpenAI, e a resposta volta com os dados reais no lugar. Provado ponta a ponta com o Codex de verdade.

Como na ponte do Claude Code, neste modo o texto cru passa pela nossa caixa, em memória, sem ser gravado. Se um dado com formato conferível escapar, o envio é bloqueado em vez de sair.

Com o Codex apontado, mia prova mostra no terminal o que o provedor recebeu, e mia guarda resume a conversa e grava no seu WikiSecret (gaveta Conversas). Veja a prova da ponte.

4 · O seu WikiSecret (segundo cérebro), lido pela IA MCP · Pro

O cérebro é o seu material anonimizado: documentos e notas com os dados reais trocados por apelidos antes de gravar. A IA lê o cérebro, nunca os originais.

Sem baixar nada: a IA lê o seu WikiSecret pela ponte

Com o interruptor abaixo ligado, a IA enxerga o seu WikiSecret no cérebro hospedado pelas 9 ferramentas buscar_notas, ler_nota, listar_notas, vizinhos, listar_entidades, ler_entidade, linha_do_tempo, ler_index e memoria_viva — sempre o conteúdo já anonimizado (apelidos, nunca nome/CPF reais).

Hoje isto vale para quem chama a API direto (seção 5), não para o Claude Code. Medimos em 28/ago: a Anthropic busca o servidor e decide usar a ferramenta, mas o claude do terminal ainda não sabe ler o bloco de resposta que ela devolve e a sessão morre com "Content block is not a input_json block". Por isso a ponte não liga o WikiSecret quando quem chama é o Claude Code, mesmo com o interruptor ligado — preferimos não ligar a quebrar a sua sessão no meio. Para o Claude Code e o Claude Desktop, o caminho que funciona hoje é o .mcp.json logo abaixo, lendo a cópia baixada.

—

Com o interruptor ligado, o token do seu WikiSecret e o endereço do servidor vão para a Anthropic dentro do pedido, porque é ela quem busca o servidor MCP — não é retenção zero. São 9 ferramentas de leitura, nenhuma escreve; e só vale na ponte da Anthropic (destino kimi/deepseek/glm não injeta nada).

Abra o console, suba os documentos e baixe a cópia; depois crie o .mcp.json abaixo na pasta do projeto. Da primeira vez leva uns cinco minutos.

Abra o console do cérebro para subir documentos, escrever notas e baixar a cópia. Depois aponte o Claude Code (ou o Claude Desktop) para ela com um .mcp.json na pasta do projeto:

{
  "mcpServers": {
    "wikisecret": {
      "command": "python",
      "args": ["C:/caminho/servidor-mcp/mcp_cerebro.py"],
      "env": { "MIA_CEREBRO": "C:/caminho/cerebro" }
    }
  }
}

Dois caminhos, os dois valem. Pela ponte (seção 2) a IA lê o seu WikiSecret no cérebro hospedado, sem baixar nada — basta ligar o interruptor da ponte. O .mcp.json abaixo continua valendo para o Claude Desktop e outros clientes que leem a cópia baixada na sua máquina.

Avançado: o cabeçalho por pedido x-mia-cerebro

Além do interruptor (que fica gravado na sua conta e vale até você desligar), você pode mandar por pedido: o cabeçalho x-mia-cerebro: on liga o WikiSecret só naquela chamada e x-mia-cerebro: off desliga só naquela chamada — o resto da sessão não muda, e o cabeçalho não vai para o provedor.

x-mia-cerebro: on
x-mia-cerebro: off

5 · API direta integração · Pro

Para anonimizar de dentro do seu sistema. A credencial é o mesmo token da ponte, no cabeçalho Authorization.

Copie o curl, troque o texto de exemplo pelo seu e rode: a resposta volta em segundos, com os apelidos e a lista de entidades encontradas.

curl -X POST https://privacy.wikimia.cloud/anonimizar \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "content-type: application/json" \
  -d '{"texto":"Contrato com João da Silva, CPF 111.444.777-35, tel (11) 98888-7777"}'

A resposta traz o texto com apelidos e a lista de entidades encontradas (tipo, apelido, posição). Documentos: POST /anonimizar-arquivo com o arquivo em multipart/form-data (TXT, CSV, XLSX/ODS, DOCX/ODT, PPTX/ODP, PDF e imagens). Sem token ou com token de plano Grátis a API responde 401/402 com o campo acao dizendo o que falta.

O que ainda não existe para ninguém perder tempo

Se o seu caso está nesta lista, o caminho hoje é um dos das seções acima — esta lista poupa você de tentar o que ainda não funciona.

• Gemini CLI pela ponte — o Gemini CLI fala o protocolo do Google; a ponte fala Anthropic (Claude Code) e OpenAI (Codex). O Gemini CLI entra quando a ponte aprender o dele.
• ChatGPT Plus / Gemini no navegador sem copiar e colar — não há gancho programático; depende da extensão de navegador, que ainda não foi construída.