> For the complete documentation index, see [llms.txt](https://docs.voa.health/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voa.health/integracao/mcp.md).

# MCP

O MCP da Voa conecta a sua conta Voa a assistentes de IA como Claude, ChatGPT e Codex. Com ele, o assistente consulta pacientes, atendimentos, documentos e modelos e redige documentos, sempre com a autorização do médico.

```
https://api.voa.health/mcp
```

A conexão sempre passa pelo login e pelo consentimento na Voa. Nunca cole senhas, tokens ou chaves na conversa.

### Como conectar

**Claude**

1. Configurações → Conectores → **Adicionar conector personalizado**.
2. Nome `Voa` e a URL acima.
3. Clique em **Conectar** e autorize na Voa.

**ChatGPT**

1. Configurações → Apps e Conectores → Avançado → ative o **Modo desenvolvedor**.
2. Crie um conector com a URL acima e autenticação OAuth.
3. Conecte e autorize na Voa.

**Codex**

1. Adicione ao `~/.codex/config.toml`:

```toml
[mcp_servers.voa]
url = "https://api.voa.health/mcp"

[mcp_servers.voa.oauth]
client_id = "codex"
```

2. Rode `codex mcp login voa` e autorize na Voa.

### Permissões

| Escopo                 | Permite                  |
| ---------------------- | ------------------------ |
| `voa:profile:read`     | Ler o perfil do usuário  |
| `voa:patients:read`    | Ler pacientes            |
| `voa:encounters:read`  | Ler atendimentos         |
| `voa:documents:read`   | Ler documentos           |
| `voa:templates:read`   | Ler modelos de documento |
| `voa:documents:create` | Propor documentos        |

{% hint style="info" %}
Os escopos nunca passam do que o papel do usuário permite na Voa.
{% endhint %}

### Documentos criados

Todo documento criado pelo assistente é uma proposta. O médico revisa e salva na Voa; nada é gravado no prontuário sem essa confirmação.

### Revogar o acesso

Em [app.voa.health](https://app.voa.health) → **Configurações** → **Integrações**, desconecte o aplicativo.