> 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/es/integrations/mcp-server.md).

# Servidor MCP

Esta guía explica cómo conectar Phalcon Compliance a un asistente de IA mediante el Model Context Protocol (MCP). Una vez conectado, puedes analizar direcciones y transacciones, y consultar los resultados de análisis existentes directamente en una conversación con tu asistente, sin cambiar al panel de Phalcon Compliance.

Phalcon Compliance identifica e informa sobre el riesgo AML. No actúa en consecuencia: el servidor MCP solo permite leer y analizar, y no puede cambiar nada en tu cuenta.

## Requisitos previos

* Una cuenta activa de Phalcon Compliance. Disponible en todos los planes.
* Un asistente de IA compatible con servidores MCP remotos.

## Conectar tu asistente

Phalcon Compliance aloja el servidor MCP. No tienes que instalar nada y se mantiene actualizado automáticamente.

Añade la siguiente URL del servidor dondequiera que tu asistente gestione servidores o conectores MCP:

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

La primera vez que tu asistente se conecte a Phalcon Compliance, se abrirá una página de autorización en tu navegador:

1. Inicia sesión en Phalcon Compliance o crea una cuenta.
2. Revisa lo que estás autorizando: adónde se te redirigirá, qué cuenta y organización usará la conexión y qué podrá hacer. Si se te pide que confirmes que reconoces la dirección de retorno, hazlo; de lo contrario, no podrás continuar.
3. Selecciona **Autorizar**.

Tu asistente está conectado. No se te volverá a pedir autorización a menos que se elimine o caduque la conexión.

<figure><img src="https://1164869870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemXp9fHpxED783hTlNif%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>

### Configuración para asistentes específicos

Sigue las instrucciones correspondientes a tu asistente. Claude Code, Codex y Cursor requieren el client ID que se muestra en su configuración, además de la URL del servidor. Copia el valor exactamente: identifica al asistente, no a tu cuenta de Phalcon Compliance, y no es una API key. No lo añadas a la URL del servidor.

Si tu asistente no aparece en esta lista, contacta con <phalcon_support@blocksec.com> para obtener instrucciones de conexión.

#### Claude

Ve a **Customize → Connectors**, selecciona **+** y luego **Add custom connector**, y pega la URL del servidor.

En los planes Team y Enterprise, un propietario añade el conector una vez en **Organization Settings → Connectors**. Después, cada miembro se conecta 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` permite usar el servidor en todos los proyectos. Si no lo incluyes, solo se añade al proyecto en el que te encuentras.

#### Codex

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

El servidor se guarda en `~/.codex/config.toml`, que utilizan tanto Codex CLI como la extensión IDE y la aplicación de escritorio. Añadirlo una vez sirve para los tres.

#### Cursor

Añade el servidor a tu `mcp.json`:

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

`CLIENT_ID` identifica a Cursor, no a tu cuenta. Cópialo exactamente como se muestra.

#### VS Code (GitHub Copilot)

Crea `.vscode/mcp.json` en tu proyecto:

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

La clave de nivel superior es `servers`, no `mcpServers`. Después, vuelve a cargar la ventana y cambia Copilot Chat al modo **Agent**; las herramientas MCP solo están disponibles en ese modo.

#### ChatGPT

Los servidores MCP personalizados requieren Developer Mode y un plan de pago de ChatGPT, y solo funcionan en la web. En los espacios de trabajo Business, Enterprise y Edu, un administrador debe habilitar MCP personalizado antes de que alguien pueda añadir un servidor.

Sigue las instrucciones de OpenAI para [habilitar Developer Mode y añadir un conector personalizado](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) y usa la URL del servidor que aparece más arriba. Deja la autenticación configurada como OAuth.

## Qué puede hacer tu asistente

Pídelo en lenguaje natural; tu asistente seleccionará la acción adecuada.

| Puedes pedir                                                | Usa cuota de análisis            |
| ----------------------------------------------------------- | -------------------------------- |
| Analizar una dirección para detectar riesgo AML             | Sí: 1 análisis                   |
| Analizar una transferencia dentro de una transacción        | Sí: 1 análisis por transferencia |
| El resultado más reciente del análisis de una dirección     | No                               |
| La lista de transferencias de una transacción               | No                               |
| El resultado más reciente del análisis de una transferencia | No                               |
| El resultado de un análisis en cola                         | No                               |
| Tu uso de análisis durante un período                       | No                               |
| La lista de cadenas compatibles                             | No                               |

En los planes **Scale y Enterprise**, tu asistente también puede enviar lotes: hasta 100 direcciones o 50 transacciones por solicitud. Cada elemento de un lote consume un análisis.

Cada resultado de análisis incluye un enlace al registro correspondiente en el panel de Phalcon Compliance.

{% hint style="warning" %}
Los resultados de análisis son una instantánea del momento en que se realizó el análisis, y tu asistente podría resumirlos o parafrasearlos. Abre el registro enlazado en el panel antes de tomar una decisión de cumplimiento.
{% endhint %}

### Elegir una cadena

Una misma dirección o hash de transacción puede existir en más de una cadena. Si no especificas a qué cadena te refieres, tu asistente te preguntará antes de analizar, salvo que el formato identifique por sí solo una única cadena, como ocurre con las direcciones de Bitcoin, Tron y Solana. Responder a esa pregunta no consume cuota.

Los resultados indican a qué cadena corresponden. Comprueba que sea la que querías antes de actuar en función de ellos.

### Analizar una transacción

El análisis se realiza a nivel de transferencia, no de transacción. Una transacción que contiene cinco transferencias requiere cinco análisis para cubrirse por completo.

Si una transacción contiene más de una transferencia, tu asistente te preguntará a cuál te refieres antes de analizarla, normalmente solicitando la dirección que recibió los fondos. Responder a esa pregunta es un paso normal, no un error, y no se consume cuota hasta que se identifica la transferencia.

De forma predeterminada, un análisis abarca tanto el origen de los fondos como su destino. Pídele a tu asistente que limite el análisis a uno de los lados si solo necesitas una dirección. En ambos casos se consume un análisis.

### Niveles de riesgo

Los niveles de riesgo se basan en tus propias reglas de Risk Engine, no en una escala fija. Cada hallazgo tiene la gravedad que asignaste a la regla que lo generó, y el nivel general es simplemente el más alto de todos ellos. La misma dirección puede obtener un nivel distinto en otra organización.

Esto implica dos cosas:

* Como el nivel general corresponde al hallazgo más alto, pregúntale a tu asistente qué hallazgo lo determinó.
* **Sin riesgo** significa que nada coincidió con tus reglas. No significa que la dirección o la transferencia esté libre de riesgo.

Pídele a tu asistente pruebas que respalden un nivel —el indicador que se activó, los importes y cuántos eventos coincidieron— en lugar de confiar únicamente en el nivel.

Las reglas se configuran en el panel de Phalcon Compliance y están disponibles en los planes Essential y superiores. No se pueden cambiar desde un asistente.

## Cuota de análisis

Los análisis que realizas con tu asistente utilizan la misma cuota que el panel y la API. No hay una cuota aparte.

Consultar resultados existentes nunca consume cuota. Si ya existe un resultado reciente, tu asistente puede consultarlo en lugar de iniciar un análisis nuevo. Pídele que vuelva a analizar cuando necesites conocer el estado actual; esto inicia un análisis nuevo y consume una unidad de tu cuota.

Cuando se agota tu cuota, tu asistente te lo indica y enlaza a la página de facturación. Para comprobar tu uso en cualquier momento, pídele a tu asistente que consulte tu uso de análisis o abre el panel.

## Permisos

La conexión tiene exactamente los mismos permisos que tienes en el panel de Phalcon Compliance, ni más ni menos.

Si tu rol en la organización es de solo lectura, tu asistente puede consultar los resultados de análisis existentes, pero no iniciar análisis nuevos. Si necesitas iniciarlos, pide acceso a un administrador de la organización.

Un asistente también puede solicitar acceso de solo lectura para sí mismo. En la página de autorización se indica lo que podrá hacer la conexión antes de que selecciones **Autorizar**.

## Organización

La conexión está vinculada a una sola organización: la que estabas usando más recientemente cuando la autorizaste. La organización aparece en la página de autorización antes de que selecciones **Autorizar**.

Para usar otra organización, desconéctate y vuelve a conectarte mientras esa organización esté activa.

## Desconectar

Elimina el servidor de Phalcon Compliance de la configuración de MCP o conectores de tu asistente. Los asistentes que admiten la revocación de tokens OAuth también revocan el token de acceso en ese momento.

Si necesitas confirmar que se ha revocado el acceso, contacta con ***<phalcon_support@blocksec.com>***.

## Limitaciones

* **Solo lectura y análisis.** La conexión no puede añadir ni eliminar entradas de listas negras y blancas, editar clientes, iniciar o detener la monitorización, ni actuar sobre alertas y casos.
* **La monitorización, Alert Hub, Customer Management y la configuración de Risk Engine** no están disponibles mediante un asistente. Para ello, usa el panel o la API.
* Para enviar lotes se requiere un plan Scale o Enterprise.

## Próximos pasos

* [Análisis de direcciones](https://docs.compliance.phalcon.blocksec.com/es/user-manual/screening/addresses.md): cómo analizar direcciones en el panel.
* [Análisis de transacciones](https://docs.compliance.phalcon.blocksec.com/es/user-manual/screening/transactions.md): cómo funciona el análisis a nivel de transferencia.
* [Planes, facturación y pagos](https://docs.compliance.phalcon.blocksec.com/es/user-manual/account/plans-billing-and-payment.md): límites de cuota y de los planes.
* [Documentación de la API](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction.md): la API REST subyacente.
