> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

> Conecta agentes y asistentes de IA directamente a identifAI mediante el Model Context Protocol.

## ¿Qué es el Model Context Protocol?

El **Model Context Protocol (MCP)** es un estándar abierto que permite a los asistentes de IA (como Claude, Cursor o cualquier framework de agentes compatible con MCP) llamar a herramientas y servicios externos durante la ejecución. Puedes imaginarlo como un puente estructurado entre un modelo de lenguaje y las API con las que necesita interactuar.

Un **servidor MCP** es un servicio ligero que expone a un cliente de IA un conjunto de **tools** con nombre. Cuando un asistente de IA está conectado a un servidor MCP, puede invocar esos tools de forma autónoma: decide cuándo llamarlos, pasa los parámetros correctos e interpreta los resultados, sin que tengas que crear una integración personalizada desde cero.

El servidor MCP de identifAI encapsula toda la API REST de identifAI y la expone como una colección de tools listos para usar, que cualquier cliente compatible con MCP puede descubrir y llamar.

> [!NOTE]
>
> Como el servidor MCP es remoto y el protocolo se basa en JSON, todos los archivos se transfieren como cadenas codificadas en base64. Esto puede causar problemas con archivos grandes (sobre todo vídeos), ya que la codificación base64 aumenta el tamaño del payload y puede superar los límites del servidor o del cliente. Para archivos grandes, te recomendamos encarecidamente usar los tools de clasificación "por URL" (p. ej., `classify_image_url`, `classify_video_url`, `classify_audio_url`) para evitar problemas de transferencia y garantizar un procesamiento fiable.

***

## ¿Por qué usar identifAI mediante MCP?

### Para flujos de trabajo basados en IA

Si desarrollas o despliegas agentes de IA, chatbots o copilots, la integración MCP es la forma más rápida de dotarlos de funcionalidades de detección de contenidos generados por IA. En lugar de escribir código de enlace con la API, describes una tarea en lenguaje natural y el agente se encarga del resto:

> *"Comprueba si esta imagen está generada por IA antes de publicarla."*
> *"Analiza este clip de audio y dime si es sintético."*

### Casos de uso habituales

> [card] Moderación de contenidos
>
> Bloquea la publicación de imágenes, vídeos o audios generados por IA en redes sociales, foros, marketplaces y comunidades online.

> [card] Fact-checking y redacciones
>
> Verifica la autenticidad de fotos, vídeos y audios en redacciones, agencias de prensa y flujos de verificación de fuentes.

> [card] Identidad y KYC
>
> Detecta deepfakes y manipulaciones en los procesos de onboarding, verificación de identidad y KYC de bancos, aseguradoras y fintech.

> [card] Copyright y protección de marca
>
> Protege la propiedad intelectual y el copyright detectando contenidos generados por IA en campañas publicitarias, activos digitales y archivos multimedia.

> [card] Integridad publicitaria y antifraude
>
> Evita el fraude publicitario y los anuncios falsos detectando contenidos generados por IA en campañas de marketing y redes publicitarias.

> [card] Broadcast y medios
>
> Protege la reputación de emisoras, televisión y radio verificando la autenticidad de los contenidos antes de su emisión.

### Ventajas frente a una integración REST directa

| | API REST | Servidor MCP |
| - | - | - |
| Esfuerzo de integración | Código de cliente HTTP personalizado | Sin código de enlace: basta con añadirlo a la configuración del agente |
| Pensado para agentes | Requiere encapsular los tools a mano | Descubrible de forma nativa por los clientes MCP |
| Multimodal | Endpoints separados para cada tipo | Los 17 tools en un único servidor |
| Polling asíncrono | Bucle de polling manual | El tool gestiona el flujo |

## Requisitos

Antes de conectarte al servidor MCP de identifAI necesitas:

1. **Una API key de identifAI.** Regístrate en [https://web.identifai.net](https://web.identifai.net/), ve a la dashboard, haz clic en el icono de usuario en la esquina superior derecha y selecciona **"Api-Key"**.
2. **Un cliente compatible con MCP**: Claude Desktop, Cursor o cualquier framework de agentes que admita el Model Context Protocol.

> [!NOTE]
>
> La API key se pasa **en cada solicitud** como parámetro del tool. El servidor nunca la almacena ni la guarda en caché: cada llamada a un tool se autentica de forma independiente directamente contra la API REST de identifAI.

***

## Endpoint público del servidor MCP

En producción puedes conectarte directamente a nuestro **servidor MCP público** en:

> **[https://mcp.identifai.net](https://mcp.identifai.net)**

Este endpoint está siempre disponible y listo para atender las solicitudes de cualquier agente o asistente compatible con MCP. No necesitas ninguna instalación local, salvo que quieras una instancia privada.

Basta con configurar tu agente con `https://mcp.identifai.net` como URL del servidor MCP.

***

## Tools disponibles

El servidor expone **17 tools** organizados por tipo de medio.

> [accordion] Tools para imágenes (6)
>
> | Tool | Descripción |
> | - | - |
> | `identifai/classify_image` | Envía un archivo de imagen para clasificar si su contenido está generado por IA |
> | `identifai/classify_image_url` | Envía la URL de una imagen para clasificar si su contenido está generado por IA |
> | `identifai/get_image_classification` | Obtiene el resultado de una clasificación por ID |
> | `identifai/get_all_image_classifications` | Obtiene los resultados de varias clasificaciones de imágenes |
> | `identifai/get_classification_heatmap` | Obtiene una heatmap que resalta las zonas generadas por IA |
> | `identifai/override_image_classification` | Aplica manualmente un override al resultado de una clasificación |

> [accordion] Tools para vídeos (5)
>
> | Tool | Descripción |
> | - | - |
> | `identifai/classify_video` | Envía un archivo de vídeo para clasificar si su contenido está generado por IA |
> | `identifai/classify_video_url` | Envía la URL de un vídeo para clasificar si su contenido está generado por IA |
> | `identifai/get_video_classification` | Obtiene el resultado de la clasificación de un vídeo por ID |
> | `identifai/get_all_video_classifications` | Obtiene los resultados de varias clasificaciones de vídeos |
> | `identifai/override_video_classification` | Aplica manualmente un override al resultado de la clasificación de un vídeo |

> [accordion] Tools para audio (5)
>
> | Tool | Descripción |
> | - | - |
> | `identifai/classify_audio` | Envía un archivo de audio para clasificar si su contenido está generado por IA |
> | `identifai/classify_audio_url` | Envía la URL de un audio para clasificar si su contenido está generado por IA |
> | `identifai/get_audio_classification` | Obtiene el resultado de la clasificación de un audio por ID |
> | `identifai/get_all_audio_classifications` | Obtiene los resultados de varias clasificaciones de audio |
> | `identifai/override_audio_classification` | Aplica manualmente un override al resultado de la clasificación de un audio |

> [accordion] Tools de usuario (1)
>
> | Tool | Descripción |
> | - | - |
> | `identifai/get_user_credits` | Obtiene el saldo de créditos restante de tu cuenta |

> [!TIP]
>
> Los jobs de clasificación son **asíncronos**. Después de enviar un archivo o una URL, usa el tool `get_*_classification` correspondiente con el ID del job devuelto para consultar periódicamente el resultado. Los agentes compatibles con MCP lo hacen automáticamente cuando les pides que esperen a que termine.

***

## Ejemplo de integración: Claude Desktop

La forma más rápida de empezar es conectar Claude Desktop directamente al **servidor MCP público de identifAI**, sin ninguna instalación local.

1. Abre (o crea) el archivo de configuración de Claude Desktop:
   * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
   * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
2. Añade el servidor de identifAI a la sección `mcpServers`:

```json theme={null}
{
  "mcpServers": {
    "identifAI": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.identifai.net/"]
    }
  }
}
```

> [!NOTE]
>
> Asegúrate de tener instalado `npx` (incluido en Node.js) para iniciar el servidor mcp-remote mediante comando.

3. Reinicia Claude Desktop. Ahora deberías ver **identifAI** en el panel de tools conectados.
4. En el chat de Claude Desktop, prueba un prompt como:

> *"Usando identifAI con la API key sk-xxxxxxxx, clasifica esta imagen y dime si está generada por IA: [https://example.com/sample.jpg](https://example.com/sample.jpg)"*

Claude llamará a `identifai/classify_image_url`, recibirá el ID del job, después consultará automáticamente `identifai/get_image_classification` y devolverá el veredicto con su puntuación de confianza.

> [!NOTE]
>
> Puedes incluir la API key directamente en el prompt, o pedir al asistente que use una key que hayas guardado en un prompt de sistema o en una variable de entorno, según cómo esté configurado tu agente.

***

## Próximos pasos

> [card] [Obtén tu API key](https://docs.identifai.net/es/quickstart.md)
>
> Sigue la guía de quickstart para crear una cuenta y obtener tu API key.

> [card] [Explora la referencia de la API](https://docs.identifai.net/es/api-reference/introduction.md)
>
> Consulta la documentación completa de la API REST con todos los endpoints disponibles.

> [card] [Clasifica una imagen](https://docs.identifai.net/es/classification/classify-image.md)
>
> Descubre cómo funciona la clasificación de imágenes de principio a fin.

> [card] [Clasifica un vídeo](https://docs.identifai.net/es/classification/classify-video.md)
>
> Descubre cómo funciona la clasificación de vídeos de principio a fin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.