> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/pt-br/integrations/mcp-server.md).

# Servidor MCP

Este guia explica como conectar o Phalcon Compliance a um assistente de IA usando o Model Context Protocol (MCP). Depois de conectado, você poderá verificar endereços e transações, além de consultar resultados de verificações existentes, diretamente em uma conversa com seu assistente — sem precisar alternar para o painel do Phalcon Compliance.

O Phalcon Compliance identifica e informa riscos de AML. Ele não atua sobre eles: o servidor MCP permite apenas leitura e verificação e não pode alterar nada na sua conta.

## Pré-requisitos

* Uma conta ativa do Phalcon Compliance. Disponível em todos os planos.
* Um assistente de IA compatível com servidores MCP remotos.

## Conectar seu assistente

O Phalcon Compliance hospeda o servidor MCP. Não é preciso instalar nada, e ele permanece atualizado automaticamente.

Adicione a seguinte URL do servidor onde seu assistente gerencia servidores ou conectores MCP:

```
https://mcp.blocksec.com/mcp
```

Na primeira vez que seu assistente chamar o Phalcon Compliance, seu navegador abrirá uma página de autorização:

1. Faça login no Phalcon Compliance ou crie uma conta.
2. Revise o que você está autorizando: para onde será redirecionado, qual conta e organização serão usadas pela conexão e o que ela poderá fazer. Se pedirem que confirme que reconhece o endereço de retorno, confirme — caso contrário, não poderá continuar.
3. Selecione **Autorizar**.

Seu assistente está conectado. Você não precisará autorizar novamente, a menos que a conexão seja removida ou expire.

<figure><img src="https://506894602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzD66AI0kygFWXLyKlwt%2Fuploads%2Fgit-blob-cfc1fdc28aa022afb5ad95e1252142d7ed892277%2Fmcp-server-authorization.png?alt=media" alt="The Phalcon Compliance authorization page, showing where you will be sent back to, the account and organization the connection will use, a checkbox confirming you recognize the return address, and what the connection will be able to do"><figcaption><p>The authorization page shows the account and organization the connection will use, and what it will be able to do.</p></figcaption></figure>

### Configuração para assistentes específicos

Siga as instruções abaixo para seu assistente. Claude Code, Codex e Cursor exigem o ID do cliente exibido na configuração, além da URL do servidor. Copie o valor exatamente: ele identifica o assistente, não sua conta do Phalcon Compliance, e não é uma chave de API. Não o acrescente à URL do servidor.

Para obter instruções de conexão para um assistente que não esteja listado aqui, entre em contato com <phalcon_support@blocksec.com>.

#### Claude

Acesse **Personalizar → Conectores**, selecione **+** e, em seguida, **Adicionar conector personalizado**, e cole a URL do servidor.

Nos planos Team e Enterprise, um proprietário adiciona o conector uma vez em **Configurações da organização → Conectores**. Em seguida, os membros se conectam a ele individualmente.

#### Claude Code

```bash
claude mcp add --scope user --transport http \
  --client-id https://claude.ai/oauth/claude-code-client-metadata \
  phalcon-compliance https://mcp.blocksec.com/mcp
```

`--scope user` disponibiliza o servidor em todos os projetos. Sem essa opção, ele é adicionado somente ao projeto em que você está.

#### Codex

```bash
codex mcp add phalcon-compliance \
  --url https://mcp.blocksec.com/mcp \
  --oauth-client-id https://chatgpt.com/oauth/codex/client.json
```

O servidor é gravado em `~/.codex/config.toml`, que é lido pela CLI do Codex, pela extensão do IDE e pelo aplicativo para desktop. Ao adicioná-lo uma vez, você o disponibiliza nos três.

#### Cursor

Adicione o servidor ao seu `mcp.json`:

```json
{
  "mcpServers": {
    "Phalcon Compliance": {
      "url": "https://mcp.blocksec.com/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com"
      }
    }
  }
}
```

`CLIENT_ID` identifica o próprio Cursor, não sua conta. Copie-o exatamente como exibido.

#### VS Code (GitHub Copilot)

Crie `.vscode/mcp.json` no seu projeto:

```json
{
  "servers": {
    "phalcon-compliance": {
      "type": "http",
      "url": "https://mcp.blocksec.com/mcp"
    }
  }
}
```

A chave de nível superior é `servers`, não `mcpServers`. Depois, recarregue a janela e mude o Copilot Chat para o modo **Agent** — as ferramentas MCP só estão disponíveis nesse modo.

#### ChatGPT

Servidores MCP personalizados exigem o Modo de desenvolvedor e um plano pago do ChatGPT, e funcionam somente na web. Nos espaços de trabalho Business, Enterprise e Edu, um administrador precisa habilitar o MCP personalizado antes que alguém possa adicionar um servidor.

Siga as instruções da OpenAI para [habilitar o Modo de desenvolvedor e adicionar um conector personalizado](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) e use a URL do servidor acima. Mantenha a autenticação definida como OAuth.

## O que seu assistente pode fazer

Peça em linguagem simples — seu assistente selecionará a ação adequada.

| Você pode pedir                                              | Usa a cota de verificações            |
| ------------------------------------------------------------ | ------------------------------------- |
| Verificar um endereço quanto a risco de AML                  | Sim — 1 verificação                   |
| Verificar uma transferência dentro de uma transação          | Sim — 1 verificação por transferência |
| O resultado mais recente da verificação de um endereço       | Não                                   |
| A lista de transferências em uma transação                   | Não                                   |
| O resultado mais recente da verificação de uma transferência | Não                                   |
| O resultado de uma verificação na fila                       | Não                                   |
| Seu uso de verificações durante um período                   | Não                                   |
| A lista de redes compatíveis                                 | Não                                   |

Nos planos **Scale e Enterprise**, seu assistente também pode enviar lotes — até 100 endereços ou 50 transações por solicitação. Cada item de um lote consome uma verificação.

Cada resultado de verificação inclui um link para o registro correspondente no painel do Phalcon Compliance.

{% hint style="warning" %}
Os resultados da verificação são um retrato do momento em que ela foi executada, e seu assistente pode resumi-los ou parafraseá-los. Abra o registro vinculado no painel antes de tomar uma decisão de conformidade.
{% endhint %}

### Escolher uma rede

O mesmo endereço ou hash de transação pode existir em mais de uma rede. Se você não especificar a rede, seu assistente perguntará antes de verificar — a menos que o formato identifique uma única rede, como ocorre com endereços de Bitcoin, Tron e Solana. Responder a essa pergunta não consome cota.

Os resultados indicam a rede a que se referem. Antes de agir com base neles, confirme que é a rede que você quis dizer.

### Verificar uma transação

A verificação funciona no nível da transferência, não da transação. Uma transação com cinco transferências exige cinco verificações para ser analisada completamente.

Se uma transação tiver mais de uma transferência, seu assistente perguntará qual delas você quer verificar — geralmente, pedindo o endereço que recebeu os fundos. Responder a essa pergunta é uma etapa normal, não um erro, e nenhuma cota é consumida até que a transferência seja identificada.

Por padrão, uma verificação cobre tanto a origem quanto o destino dos fundos. Se precisar de apenas uma direção, peça ao seu assistente que restrinja o escopo. De qualquer forma, isso custa uma verificação.

### Níveis de risco

Os níveis de risco vêm das suas próprias regras do Risk Engine, não de uma escala fixa. Cada ocorrência recebe a gravidade que você definiu para a regra que a gerou, e o nível geral é simplesmente o mais alto entre elas. O mesmo endereço pode retornar com um nível diferente para outra organização.

Isso tem duas implicações:

* Como o nível geral corresponde à ocorrência individual mais alta, pergunte ao seu assistente qual ocorrência determinou esse nível.
* **Sem risco** significa que nada correspondeu às suas regras. Não significa que o endereço ou a transferência seja seguro.

Peça ao seu assistente as evidências por trás de um nível — o indicador acionado, os valores, quantos eventos corresponderam — em vez de confiar apenas no nível.

As regras são configuradas no painel do Phalcon Compliance e estão disponíveis nos planos Essential e superiores. Não podem ser alteradas por meio de um assistente.

## Cota de verificações

As verificações feitas pelo seu assistente usam a mesma cota do painel e da API. Não há uma cota separada.

Consultar resultados existentes nunca consome cota. Se já houver um resultado recente, seu assistente poderá consultá-lo em vez de executar uma nova verificação. Peça para verificar novamente quando precisar do estado atual — isso executará uma nova verificação e consumirá uma unidade da sua cota.

Quando sua cota acabar, seu assistente avisará e incluirá um link para a página de cobrança. Para consultar seu uso a qualquer momento, pergunte ao seu assistente sobre o uso de verificações ou abra o painel.

## Permissões

A conexão tem exatamente as mesmas permissões que você tem no painel do Phalcon Compliance — nem mais, nem menos.

Se sua função na organização permitir apenas visualização, seu assistente poderá consultar resultados de verificações existentes, mas não poderá executar novas verificações. Se precisar executá-las, peça acesso a um administrador da organização.

Um assistente também pode solicitar acesso somente para leitura para si mesmo. As ações que uma conexão poderá realizar estão listadas na página de autorização antes de você selecionar **Autorizar**.

## Organização

A conexão está vinculada a uma única organização: aquela que você estava usando mais recentemente quando a autorizou. A organização aparece na página de autorização antes de você selecionar **Autorizar**.

Para usar outra organização, desconecte e conecte novamente enquanto essa organização estiver ativa.

## Desconectar

Remova o servidor do Phalcon Compliance das configurações de MCP ou de conectores do seu assistente. Assistentes compatíveis com a revogação de tokens OAuth também revogam o token de acesso nesse momento.

Se precisar confirmar que o acesso foi encerrado, entre em contato com ***<phalcon_support@blocksec.com>***.

## Limitações

* **Somente leitura e verificação.** A conexão não pode adicionar nem remover itens das listas de bloqueio e de permissão, editar clientes, iniciar nem interromper o monitoramento ou realizar ações em alertas e casos.
* **Monitoramento, Alert Hub, Customer Management e a configuração do Risk Engine** não estão disponíveis por meio de um assistente. Use o painel ou a API para acessá-los.
* O envio de lotes exige um plano Scale ou Enterprise.

## Próximas etapas

* [Verificação de endereços](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/screening/addresses.md): verificar endereços no painel.
* [Verificação de transações](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/screening/transactions.md): como funciona a verificação no nível da transferência.
* [Planos, cobrança e pagamento](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/account/plans-billing-and-payment.md): limites de cota e dos planos.
* [Documentação da API](https://docs.compliance.phalcon.blocksec.com/pt-br/api-documentation/introduction.md): a API REST subjacente.
