# API de LinkedIn y asistentes de IA (MCP)
Todo lo que hace en las páginas de LinkedIn también puede realizarse desde un script o un asistente de IA: sus clientes potenciales, la cola de solicitudes de conexión, sus reglas de ICP (incluyendo qué países acepta y qué tan grande debe ser la red de un cliente potencial), su bandeja de entrada, sus agentes de IA y su configuración.
No hay nada nuevo que configurar. Utiliza la **misma clave de API que el resto de DM Champ**, por lo que si ya llama a nuestra API o tiene un asistente de IA conectado, ya está listo.
## Dónde encontrar su clave
Configuración → Integraciones → Clave de API. Si aún no tiene una, haga clic en **Generar clave de API**. Los pasos completos se encuentran en [Acceso a la API](api-access.md).
No hay una clave de LinkedIn separada para crear, rotar o revocar. La clave actúa como usted, con los mismos permisos que tiene en la aplicación, así que trátela como una contraseña. Revocarla en Configuración corta instantáneamente el acceso a cualquier script o asistente conectado.
## Llamar a la API directamente
- **URL base:** `https://app.sdrpilot.ai/api/v1`
- **Encabezado:** `X-API-Key: YOUR_API_KEY`
- **Descripción legible por máquina:** `https://app.sdrpilot.ai/api/v1/docs/openapi.yaml`
(también disponible como `.json`)
El documento OpenAPI es público y describe cada ruta, por lo que la mayoría de las herramientas de API y generadores de código pueden importarlo directamente sin necesidad de una clave.
`Authorization: Bearer YOUR_API_KEY` también funciona. Lo que no puede hacer es enviar una clave incorrecta y esperar que pase a otra cosa: una vez que se presenta una clave, la respuesta se basa en esa clave.
Qué sucede cuando algo sale mal:
| Respuesta | Qué significa |
|---|---|
| `401` | La clave falta, está mal formada o no es aceptada. |
| `403` | La clave es válida, pero esa cuenta no tiene un espacio de trabajo de LinkedIn o aún no tiene permiso. |
| `429` | Demasiados intentos rechazados en un minuto para esa clave. Reduzca la velocidad. |
| `502` `dmchamp_unreachable` | No pudimos verificar su clave en ese momento. Nunca se trata como un pase. Vuelva a intentarlo. |
## Conectar un asistente de IA
Las herramientas de LinkedIn residen en el mismo punto final MCP que las de DM Champ, con la misma clave de API, por lo que un asistente que ya haya conectado las detectará automáticamente. Si aún no ha conectado ninguno, siga [Conectar asistentes de IA (MCP)](connect-ai-clients.md) y utilice el punto final que aparece allí.
::: master-only
El punto final es `https://mcp.youraiconnector.com/mcp`, autenticado con el encabezado `X-API-Key`, exactamente como se describe en Conectar asistentes de IA (MCP).
:::
Las herramientas de LinkedIn tienen el prefijo **`linkedin_`**, por lo que son fáciles de identificar en la lista de herramientas de su asistente y fáciles de solicitar por su nombre ("usa las herramientas de LinkedIn para mostrarme lo que está en cola"). No existen permisos por herramienta: una herramienta puede hacer todo lo que usted puede hacer en la aplicación.
## Ejemplo 1: solo aceptar leads de ciertos países
Su perfil de ICP contiene las reglas que los leads deben cumplir. Esto establece una lista de permitidos para los Países Bajos y Bélgica. Los códigos de país son de dos letras, en mayúsculas.
```bash
curl -X PUT https://app.sdrpilot.ai/api/v1/icp/YOUR_ICP_ID/filters \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"countries":{"mode":"allow","codes":["NL","BE"]}}'
```
Dos cosas a tener en cuenta. El cuerpo es el conjunto **completo** de reglas, no un parche: una regla que omita se desactivará. Y la respuesta incluye un bloque `impact_on_queue` que le indica cuántas solicitudes de conexión ya en cola no cumplirían las nuevas reglas, por ejemplo `{"examined": 389, "would_withdraw": 155}`.
Guardar las reglas no retira nada por sí solo.
En un asistente, simplemente diría: "Establece mi ICP para aceptar solo los Países Bajos y Bélgica, y dime qué efecto tendría eso en mi cola".
## Ejemplo 2: ver lo que está en cola
Solicitudes de conexión que han sido aprobadas pero aún no enviadas:
```bash
curl -s "https://app.sdrpilot.ai/api/v1/connections/queue?status=queued&limit=100" \
-H "X-API-Key: YOUR_API_KEY"
```
Cada fila contiene el nombre de la persona, el titular, la empresa, la ubicación, el país, su número de conexiones y seguidores, y la puntuación. Puede restringir la lista con `country`, `min_score`, `max_score` y `source`, y navegar por ella con `limit` y `cursor`. Aquí solo aparecen las solicitudes en cola y pendientes de aprobación. Las solicitudes ya enviadas son historial y no se pueden cambiar.
## Ejemplo 3: retirar a todos los que están fuera de sus países
Después de cambiar sus reglas, vuelva a comprobar la cola con ellas. Sin `apply=true`, esto es una vista previa y no cambia nada:
```bash
curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen" \
-H "X-API-Key: YOUR_API_KEY"
```
Recibirá información sobre cuántos se examinaron, cuántos serían retirados y un desglose por regla, como `country` y `network_too_small` (la red del lead era más pequeña que su mínimo). ¿Está satisfecho? Ejecútelo de nuevo con `?apply=true` y esas solicitudes serán retiradas.
```bash
curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen?apply=true" \
-H "X-API-Key: YOUR_API_KEY"
```
Si prefiere retirar un conjunto específico, publique los ids en su lugar, o un filtro como `{"filter":{"status":"queued","country":"NG"}}` para eliminar todo lo que coincida. Envíe ids o un filtro, no ambos.
## Solución de problemas
- **`401` en cada llamada** — la clave falta o es incorrecta. Cópiela de nuevo desde Ajustes → Integraciones → Clave API.
- **`403` aunque la clave funciona en otros lugares** — esa cuenta no está vinculada a un espacio de trabajo de LinkedIn, o LinkedIn aún no está habilitado para ella.
- **`502 dmchamp_unreachable`** — un problema temporal al comprobar su clave. No se permitió el paso de nada; inténtelo de nuevo.
- **Una regla no coincide con nada** — los códigos de país deben tener el formato de dos letras en mayúsculas (`NL`, no `Netherlands` o `nl`), y los códigos de idioma deben estar en minúsculas.
- **El asistente no muestra herramientas de LinkedIn** — vuelva a conectarlo para que recargue la lista de herramientas y compruebe que está utilizando la misma clave API.
---
## Próximos pasos
- [Conectar asistentes de IA (MCP)](connect-ai-clients.md) — configure Claude, ChatGPT o Cursor con su clave.
- [Acceso a la API](api-access.md) — genere o rote la clave que utiliza esto.