# Conectar tu IA (MCP)

Conecta el asistente que ya usas — ChatGPT, Claude, Claude Code, Codex o Cursor — a tu proyecto de Instasent, para que trabaje con tu audiencia, tus campañas y tus informes en lenguaje natural.

**Language:** es
**Audience:** platform
**TLDR:** Instasent tiene un servidor MCP en https://develop-mcp.instasent.com/mcp. En un asistente web como ChatGPT o Claude lo añades como conector personalizado, entras y lo activas en cada conversación. En un asistente de código como Claude Code, Codex o Cursor pegas un solo prompt y se configura él solo, incluidas las Instasent Skills (publicadas como la Agent Skill `instasent`). En ambos casos aceptas los permisos en bloque y eliges un proyecto, y a partir de ahí lee tu audiencia, tus campañas y tus informes y prepara trabajo contigo. Nunca envía un mensaje ni activa nada —eso lo confirmas tú en el panel— y puedes revocarlo cuando quieras desde Apps conectadas.
**Translation key:** platform.developers-and-apps.connect-your-ai
**Search keywords:** conectar tu ia, claude, claude code, chatgpt, cursor, codex, gemini cli, mcp, model context protocol, servidor mcp, conector personalizado, conector, conectar un agente, agente de ia, agentes de ia, agente, agent skills, skills, instasent-cdp, playbooks, oauth
**Related pages:** /platform/en/developers-and-apps/connect-your-ai, /platform/es/developers-and-apps, /platform/es/developers-and-apps/managing-connected-apps, /platform/es/developers-and-apps/third-party-data-access
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/es/llms.txt
**This page:** https://docs.instasent.com/platform/es/developers-and-apps/connect-your-ai/ (HTML) · https://docs.instasent.com/platform/es/developers-and-apps/connect-your-ai.md (Markdown)
**Other language (en):** https://docs.instasent.com/platform/en/developers-and-apps/connect-your-ai.md

Puedes conectar el asistente de IA que ya usas para que trabaje directamente con
tu proyecto de Instasent. En vez de recorrer el panel y copiar cifras de él,
preguntas con tus palabras: *«¿cuántos clientes compraron alguna vez pero no en
los últimos tres meses?»*, *«prepárame una campaña para ese grupo»*.

Esto funciona porque Instasent tiene un **servidor MCP**. MCP (*Model Context
Protocol*) es el estándar abierto con el que los asistentes se enchufan a otras
herramientas; en la práctica es el idioma común que le permite al tuyo entender
tu proyecto. El modelo es tuyo: lo conectas, y sigue funcionando donde ya lo
usas.

## ¿Cuál usas?

Configurarlo es distinto según dónde viva tu asistente, así que empieza por aquí
y sigue solo tu mitad.

- [Un asistente web](#asistentes-web-chatgpt-y-claude) - ChatGPT, Claude y similares. Añades Instasent como conector desde una pantalla de ajustes — sin terminal y sin instalar nada.
- [Un asistente de código](#asistentes-de-código-claude-code-codex-cursor-y-gemini-cli) - Claude Code, Codex, Cursor, Gemini CLI. Pegas un solo prompt y tu asistente se configura solo.

## Asistentes web: ChatGPT y Claude

#### 1. Dale la dirección a tu asistente

Allí donde te pida añadir un **servidor MCP** o un **conector
personalizado**, pega esta URL:

```text
https://develop-mcp.instasent.com/mcp
```

Eso es toda la configuración: sin claves, sin ficheros, sin nada que
instalar. El nombre que le pongas es solo para que lo reconozcas en tu
lista — llámalo como quieras.

#### 2. Entra y aprueba

Tu asistente te lleva a una pantalla de Instasent. Entras con tu cuenta, ves
quién pide acceso, **qué permisos** y **para qué proyecto**, y apruebas. Tu
contraseña no llega nunca al asistente.

#### 3. Actívalo en la conversación

La mayoría de asistentes dejan los conectores apagados en cada chat nuevo.
Activa Instasent desde el menú de herramientas o conectores de la
conversación, y empieza a preguntar.

> **Note**: Los permisos se conceden **en bloque**: aceptas o rechazas el conjunto que
> pide el asistente, en vez de ir marcando casillas. Es como funcionan las
> conexiones que ya usas, y evita el fallo clásico de dejarse un permiso fuera y
> que a partir de ahí fallen la mitad de las respuestas.

#### Claude

Entra en **Customize → Connectors**, elige **Add custom connector** y pega
`https://develop-mcp.instasent.com/mcp`. Este atajo abre ese diálogo con los campos ya rellenos
— la confirmación sigue siendo tuya:

[Añadir Instasent a Claude](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Instasent\&connectorUrl=https%3A%2F%2Fdevelop-mcp.instasent.com%2Fmcp)

Después, en cada conversación, activa Instasent desde el menú **+ →
Connectors**. En un plan **Team o Enterprise** un propietario puede añadirlo
una sola vez para toda la organización desde **Organization settings →
Connectors**, y los miembros solo pulsan **Connect**. En el plan **Free**,
Claude permite hoy un único conector personalizado.

#### ChatGPT

Los conectores personalizados están detrás del modo desarrollador:
**Settings → Apps & Connectors → Advanced settings** para activarlo, luego
**Settings → Connectors → Create**, pega `https://develop-mcp.instasent.com/mcp` y elige
**OAuth** como método de autenticación. Completa el acceso a Instasent y
activa el conector en cada conversación desde el menú de herramientas.

> **Tip**: Lo más probable es que tu asistente te avise la primera vez de que Instasent
> es una aplicación **no verificada**. Es lo esperable en un conector añadido
> por URL, e Instasent te enseña lo mismo desde su lado: siempre ves quién pide
> acceso antes de aprobar.

### Instasent Skills, en un asistente web

Las **Instasent Skills** son la forma en que el criterio operativo de Instasent
llega a tu asistente: cómo se escribe un filtro de audiencia para que no acabe
seleccionando a nadie sin avisar, cuánto cuesta de verdad un mensaje una vez
cuentas su codificación, qué cifras son aproximaciones y no se pueden citar como
exactas.

**Ya las tienes.** La conexión te las sirve en vivo y tu asistente las consulta
por su cuenta — no hay que instalar nada para que funcione. Lo de abajo es solo
para tener una copia cargada de forma permanente.

- [Descargar las Instasent Skills](https://develop-mcp.instasent.com/.well-known/skills/instasent-skills.zip) - Todo en un fichero, publicado en el formato Agent Skills que leen los asistentes. Descargarlo no pide cuenta ni credencial.

En **Claude**, entra en **Customize → Skills**, elige **Upload a skill** y
selecciona ese fichero.

Otros asistentes añaden conocimiento a su manera, y esas formas cambian a
menudo. En vez de adivinarlo por ti, pregúntaselo al tuyo — pega esto:

```text
Instasent publica su conocimiento de producto —las Instasent Skills— como
una Agent Skill, una carpeta de ficheros markdown. Puedo descargarla en zip
desde:
https://develop-mcp.instasent.com/.well-known/skills/instasent-skills.zip

Dos cosas:

1. ¿Puedes cargar conocimiento así — una skill, un fichero de conocimiento,
   un fichero de proyecto, cualquier equivalente? Si puedes, dime
   exactamente dónde lo subo en tu interfaz. Si no puedes, dímelo
   claramente y no te inventes un apaño.

2. En cualquier caso, guarda esto en tu memoria para nuestras próximas
   conversaciones: ese mismo conocimiento está disponible en vivo en el
   conector de Instasent, a través de su herramienta get_playbook. Antes de
   responder cualquier cosa sobre Instasent —cómo se escribe un filtro de
   audiencia, cuánto cuesta un mensaje, qué incluye una cifra— llama a
   get_playbook y responde a partir de ahí, en vez de a partir de lo que ya
   creas saber de la plataforma. Guarda esa instrucción en tu memoria
   ahora.
```

> **Warning**: **Las skills instaladas en un sitio se quedan en ese sitio.** Subirlas a
> Claude no las pone en Claude Code, e instalarlas en Claude Code no las pone en
> Claude — no se comparten. Si usas los dos, instálalas en los dos.

## Asistentes de código: Claude Code, Codex, Cursor y Gemini CLI

Estos pueden configurarse solos. Pega esto y deja que tu asistente lo haga todo
—la conexión y las Instasent Skills— de una vez:

```text
Configura Instasent CDP en este proyecto. Ejecuta tú los comandos en vez de
pedirme que los ejecute yo.

1. Comprueba si ya tienes configurado el servidor MCP de Instasent y
   añádelo si no lo está. Es un servidor remoto que habla Streamable HTTP
   en https://develop-mcp.instasent.com/mcp — no hay claves, la URL es toda la configuración.
   En Claude Code eso es:
     claude mcp add --transport http instasent https://develop-mcp.instasent.com/mcp
   En otro asistente, añade esa misma URL a tu fichero de configuración MCP.

2. Comprueba si ya tienes instaladas las Instasent Skills e instálalas si
   no lo están:
     npx skills add https://staging-instasent-docs-nextjs.oscar-284.workers.dev

Después párate y dime tres cosas: qué cubre, tras leer el SKILL.md que hayas
instalado; qué tengo que hacer yo para terminar de entrar; y si hay que
reiniciar esta sesión para que aparezcan las herramientas de Instasent.
```

Esa instrucción final no está de adorno. **Entrar es cosa tuya** —se abre el
navegador y solo tú puedes aprobarlo— y la mayoría de asistentes no se enteran
de que hay un servidor MCP nuevo hasta la siguiente sesión. Pedirle que te
cuente las dos cosas te ahorra descubrirlo por silencio.

> **Note**: **Claude Code**, **Codex**, **Cursor** y **Gemini CLI** leen las Instasent
> Skills de la carpeta en la que las deja el instalador — los dos primeros
> verificados por nosotros, los otros dos documentados por sus fabricantes.
> Sabe además dónde guardan las suyas decenas de asistentes más, y deja los
> ficheros donde cada uno los busca.

#### Prefiero hacerlo a mano

Tres pasos, y puedes parar en el primero si solo quieres la conexión.

**1 · Añade el servidor MCP.** En Claude Code:

```bash
claude mcp add --transport http instasent https://develop-mcp.instasent.com/mcp
```

En otro asistente, añade esa misma URL al fichero de configuración que use
para servidores MCP. Después entra — en Claude Code,
`claude mcp login instasent`.

**2 · Instala las Instasent Skills.** Un comando, y encuentra él solo la
carpeta de skills de tu asistente:

```bash
npx skills add https://staging-instasent-docs-nextjs.oscar-284.workers.dev
```

Lo que te pregunta es **dónde**. *En el repositorio* viaja con el código,
así que todo el equipo —y cualquier agente que trabaje sobre esa base de
código— la tiene sin instalar nada; esa es la que quieres en equipo. *Solo
para ti* vale para todos los proyectos que abras, y `--global` la elige sin
preguntarte.

**3 · O sáltate el instalador** y descomprime la descarga de arriba en la
carpeta de la que tu asistente lee las skills. En Claude Code:

```bash
unzip -o instasent-skills.zip -d ~/.claude/skills/
```

#### Ya lo tenías instalado con el nombre anterior

Las Instasent Skills se llamaban `instasent-cdp` y ahora se llaman
`instasent`. Ese nombre da nombre a la carpeta, así que al reinstalar **la
que ya tenías no se actualiza: aparece una nueva al lado**.

Si te quedas con las dos, tu asistente lee las dos, y la vieja está
congelada en la versión del día que la instalaste. Bórrala:

```bash
rm -rf .agents/skills/instasent-cdp
```

Esa es la ruta si la instalaste *en el repositorio*. Si la instalaste solo
para ti, cuelga de la carpeta de skills de tu asistente, que en Claude Code
es `~/.claude/skills/instasent-cdp`.

Con la conexión MCP pasa lo mismo si sigues los pasos de arriba tal cual:
acabarías con `instasent-cdp` e `instasent` apuntando al mismo servidor, y
con las mismas herramientas duplicadas. El nombre viejo sigue funcionando,
así que puedes quedártelo y no tocar nada, o retirarlo:

```bash
claude mcp remove instasent-cdp
```

## Qué hace un asistente conectado

Trabaja con un **conjunto acotado de herramientas**, no con toda la API. En la
práctica puede mirar tu proyecto como lo mirarías tú y contarte lo que
encuentra: quién está en tu audiencia y cuántos cumplen una condición, qué has
estado enviando y cómo fue, qué hacen tus automatizaciones y qué puede enviar
hoy tu proyecto. También puede dejarte trabajo preparado — un segmento guardado
a partir de la audiencia que acabáis de definir, una campaña redactada y dejada
en borrador — y puede leer esta documentación por su cuenta, así que responde
preguntas sobre Instasent sin que le pegues enlaces.

La lista exacta crece y cambia con cada versión, así que la forma honesta de
pensarlo es por su forma: **lee tu proyecto y prepara trabajo; no lo ejecuta.**

### Lo que no hace nunca

> **Warning**: **Ningún asistente envía.** No existe ninguna herramienta que mande un
> mensaje, lance una campaña o ponga en marcha una automatización. Puede dejarlo
> todo listo — el segmento guardado, la campaña redactada — y el botón de enviar
> lo pulsas tú en el panel. Esa frontera no depende de los permisos que hayas
> concedido: no está en la superficie que tu asistente ve, con ningún permiso.

Tampoco importa tus contactos ni exporta tu lista. Eso vive en la API, para
integraciones que portan su propia credencial — ver
[Tokens de API](/platform/es/developers-and-apps/api-tokens).

## Comprobar que funciona

La prueba honesta no es listar un directorio, es pedirle algo que solo un
asistente conectado podría responder:

> *«Recomiéndame un segmento para winbacks y dime cuántos contactos tendría.»*

Una buena respuesta vuelve con **una propuesta concreta y un número de tu
proyecto**: clientes que compraron antes pero no desde cierta fecha, contados.
Si en cambio recibes consejos generales sobre campañas de winback y ningún
número, no está conectado.

Esa pregunta es buena prueba precisamente porque necesita las dos mitades: tus
datos para el recuento, y las Instasent Skills para construir el segmento como
esta plataforma guarda eso de verdad — la recencia vive en el contacto, no en
los eventos.

> **Warning**: **Una skill instalada es una foto.** Se compila del servidor vivo en la misma
> versión, así que nunca puede describir algo que no esté ahí — pero, una vez en
> tu disco, la plataforma sigue avanzando. **Donde tu copia instalada y una
> respuesta en vivo no coincidan, manda la respuesta en vivo y la copia está
> vieja.** Actualizarla es un comando, y merece la pena lanzarlo de vez en
> cuando:
> 
> ```bash
> npx skills update
> ```

## Mantener el control

- La conexión alcanza **solo el proyecto que elegiste** y solo los permisos que
  aprobaste.
- El **tipo de acceso** de tu proyecto se aplica por encima, y puede retener o
  anonimizar los datos personales: un asistente puede acabar pudiendo contar una
  audiencia sin poder ver quién está dentro. Ver
  [Acceso a datos](/platform/es/developers-and-apps/third-party-data-access).
- Todo asistente conectado aparece en
  [Apps conectadas](/platform/es/developers-and-apps/managing-connected-apps)
  con sus permisos, y puedes **desconectarlo cuando quieras**. Pierde el acceso
  al instante.

> **Tip**: ¿Usas un asistente que no puede conectarse por MCP? Puede leer igualmente
> estas guías: apúntalo a
> [https://staging-instasent-docs-nextjs.oscar-284.workers.dev/platform/es/llms.txt](https://staging-instasent-docs-nextjs.oscar-284.workers.dev/platform/es/llms.txt),
> un índice en texto plano del que puede descargarse páginas sueltas.

¿Estás construyendo tu propia app o agente sobre Instasent, para que lo instalen
otros clientes? Eso es el lado de desarrollo:
[Connected apps (OAuth)](/developers/product-api/connected-apps-and-oauth).

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.