API y MCP

Accede a Point11 desde tu propio software, asistente de IA o terminal.

Resumen#

El servidor MCP, la API y la herramienta de línea de comandos hacen lo mismo que tú en el panel: leen tus campañas y resultados e inician el mismo trabajo.

  • Servidor MCP: conecta Claude, ChatGPT u otro asistente de IA.
  • API: llama a Point11 desde tu propio código en https://point11.ai/api/v1.
  • CLI: usa la API desde tu terminal.

Inicia sesión para abrir la referencia de la API; está disponible para los miembros de una organización de Point11. Enumera cada solicitud, qué recibe y qué devuelve, y qué acciones del panel pueden realizar el servidor MCP, la API y la CLI. Para probar anuncios y otras creatividades con los gemelos digitales de tus clientes, consulta Prueba creatividades con la API.

Conecta un asistente de IA#

Usa esta URL del servidor MCP: https://point11.ai/api/mcp. Inicia sesión en Point11 y aprueba el acceso cuando se te solicite. Si perteneces a más de una organización, dile a tu asistente cuál debe usar. Para conectarte con una clave API, sigue los pasos de tu cliente a continuación.

Para darle a tu asistente solo los productos que usas, conéctate con una clave API y añade sus nombres a la URL en minúsculas y separados por comas, por ejemplo https://point11.ai/api/mcp?products=discovery,inspector. Una lista de herramientas más corta le deja a tu asistente más espacio para trabajar. Para iniciar sesión, usa exactamente la URL indicada arriba, sin nada después de /api/mcp. Point11 solo enumera la versión actual de cada herramienta; un asistente que todavía usa una versión anterior sigue funcionando.

Business y Alpha tienen la mayor cantidad de herramientas, así que también puedes añadir solo una parte de cualquiera de ellos: el producto, un punto y la parte, por ejemplo business.customers. Business tiene profiles, customers, crm, goals, products, measurement y google-ads. Alpha tiene chat, projects, files, workflows, ads, brand-kits, advisor y connectors. Combina productos y partes como quieras, por ejemplo https://point11.ai/api/mcp?products=discovery,business.customers. Si tu asistente busca herramientas a medida que las necesita, puede seguir usando un producto completo o todo el servidor.

Los registros y los clientes pueden leer la descripción del servidor en https://point11.ai/api/mcp/server-card.

Claude en la web y en escritorio#

  1. Abre Customize > Connectors y luego + > Add custom connector.
  2. Ponle el nombre Point11, introduce exactamente https://point11.ai/api/mcp y selecciona Add y luego Connect.
  3. En una conversación, abre + > Connectors y habilita Point11.

En los planes Team y Enterprise, un propietario debe añadir primero el conector en Organization settings > Connectors. Consulta la guía de conectores de Claude.

Claude Code#

Ejecuta en tu terminal:

bash
claude mcp add --transport http point11 https://point11.ai/api/mcp

Después abre Claude Code, ejecuta /mcp y selecciona Point11 para autenticarte. Para usar una clave API, añádela como encabezado:

bash
claude mcp add --transport http point11 https://point11.ai/api/mcp \
  --header "Authorization: Bearer $POINT11_API_KEY"

Consulta la guía de MCP de Claude Code.

ChatGPT en la web#

  1. Abre Settings > Security and login y habilita Developer mode.
  2. Abre Plugins > +. Introduce Point11, una descripción breve y la URL del servidor en Connection; después crea la conexión.
  3. Revisa las herramientas, inicia una conversación nueva y selecciona Point11 en el menú de herramientas.

La disponibilidad depende de tu cuenta y de los ajustes del espacio de trabajo. Consulta la guía de conexión de OpenAI.

ChatGPT para escritorio y Codex#

En la aplicación de escritorio, abre Settings > MCP servers > Add server. Ponle el nombre Point11, elige Streamable HTTP e introduce la URL del servidor. Guarda, selecciona Restart y luego Authenticate.

Para la CLI de Codex, ejecuta:

bash
codex mcp add point11 --url https://point11.ai/api/mcp
codex mcp login point11

Para usar una clave API, indica la variable de entorno que la contiene:

bash
codex mcp add point11 --url https://point11.ai/api/mcp --bearer-token-env-var POINT11_API_KEY

Los clientes de escritorio, CLI e IDE comparten la configuración de tu ordenador. Consulta la guía de MCP de OpenAI.

Consulta tu panel en tu asistente#

Pide una vista del panel de Discovery, como Cuota de marca, Tasa de éxito de marca o Competidores. Un asistente compatible con aplicaciones interactivas muestra la misma tarjeta que ves en tu panel, con un enlace para abrirla en Point11. Los demás asistentes reciben un breve resumen de las mismas cifras y el enlace.

Inicia sesión o usa una clave API#

  • Inicia sesión con tu propia cuenta. Point11 te pide que apruebes el acceso y, después, tu asistente o herramienta actúa con tu rol en cada organización a la que perteneces. Úsalo para asistentes de IA y para tu propio trabajo.
  • Usa una clave API para software que funciona sin ti, como un script o una tarea programada. Una clave actúa para una sola organización y solo puede usar el acceso que le des.

Algunas cosas siempre te necesitan a ti. Tus propias conversaciones y proyectos de Alpha, los comentarios y los borradores de estudios de Research pertenecen a una persona, así que una clave API no puede acceder a ellos. Pausar o eliminar una campaña, invitar a alguien o quitar a un miembro requiere primero tu aprobación. Ves la organización y exactamente qué va a cambiar, y tu aprobación solo vale para esa solicitud. La facturación, las claves API y los roles de los miembros solo se cambian en el panel.

El trabajo que inicias desde el servidor MCP, la API o la CLI cuenta para tu plan igual que en el panel.

Elige qué puede hacer cada asistente#

Cada asistente de IA o aplicación que ha actuado en tu nombre aparece en Configuración > Seguridad, en Aplicaciones conectadas. Elige qué puede hacer cada uno en esa organización: Completo, Solo lectura o Bloqueado. Los propietarios y administradores también eligen qué pueden hacer los asistentes de los miembros en toda la organización en Configuración > Seguridad > Organización, en Clientes de IA (MCP): Permitido, Solo lectura o Desactivado, y revocan la aplicación de un miembro en Aplicaciones conectadas de los miembros. Un cambio se aplica a partir de la siguiente solicitud y no afecta a las claves API.

Crea una clave API#

Los administradores y propietarios pueden crear claves.

  1. Abre Configuración > Claves API y selecciona Crear clave.
  2. Introduce un Nombre y elige su Acceso para cada producto, cuándo Caduca y a quién Pertenece.
  3. Selecciona Crear y copia la clave. Solo la verás una vez.

Guarda la clave en un gestor de secretos, nunca en tu código. Una organización puede tener hasta 10 claves activas. Para desactivar una clave, selecciona Revocar; Rotar le asigna un secreto nuevo. Una clave que pertenece a Mí se revoca en cuanto dejas la organización o ya no puedes gestionar claves; una que pertenece a La organización sigue funcionando.

Envía tu primera solicitud#

Envía tu clave como token Bearer:

bash
curl https://point11.ai/api/v1/discovery/campaigns \
  -H "Authorization: Bearer $POINT11_API_KEY"

Las solicitudes de lectura usan GET. Las solicitudes que cambian algo usan POST con un cuerpo JSON y un encabezado Idempotency-Key con un UUID nuevo:

bash
curl https://point11.ai/api/v1/inspector/scans/start \
  -H "Authorization: Bearer $POINT11_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Si inicias sesión en lugar de usar una clave, envía también Point11-Organization con el ID de tu organización. Cópialo en Configuración > Claves API.

Gestiona las respuestas#

  • Reintentos. Para reintentar una solicitud de forma segura, envíala de nuevo con el mismo Idempotency-Key. Al reintentar una creación o un inicio recibes su primera respuesta y nada se ejecuta dos veces. Cualquier otro cambio se vuelve a ejecutar al reintentarlo y responde con el estado en que queda, así que un borrado reintentado que responde 404 significa que el elemento ya no existe. Usa una clave nueva para cada solicitud nueva. A través del servidor MCP, tu asistente envía la clave como idempotencyKey. Es obligatoria para crear o iniciar algo; para cualquier otro cambio es opcional, y una solicitud sin clave se ejecuta como una solicitud nueva.
  • Listas. Pasa limit, hasta 100. Para obtener la página siguiente, pasa el nextCursor de la respuesta anterior como cursor. nextCursor es null en la última página.
  • Trabajo más largo. Al iniciar un análisis o una campaña, recibes 202 de inmediato con un runId. Consulta su progreso con GET /api/v1/platform/runs-v2/{runId}, o con platform_runs_get_v2 en el servidor MCP.
  • Errores. Cada error tiene un code, un message y un request_id. Decide qué hacer según el code e incluye el request_id cuando pidas ayuda.
  • Límites. Cada clave tiene un presupuesto de solicitudes, y también cada persona que inicia sesión, en todas las organizaciones y asistentes que usa. Los encabezados RateLimit-Remaining y RateLimit-Reset muestran lo que queda. Cuando se agota, recibes 429; espera los segundos que indica Retry-After y vuelve a intentarlo.

Usa la CLI#

La CLI es Restish, que lee la referencia de la API y convierte cada solicitud en un comando con su mismo nombre, como discovery-campaigns-list. Usa una clave API. Instala Restish, por ejemplo con brew install restish, guarda tu clave en POINT11_API_KEY y conecta Restish a Point11:

bash
restish api connect p11 https://point11.ai --no-discover
restish api set p11 'profiles.default.auth: {type: bearer, params: {token: env:POINT11_API_KEY}}'
restish api set p11 'profiles.default.credentials.apiKey.auth: {type: bearer, params: {token: env:POINT11_API_KEY}}'
restish api sync p11

Después, ejecuta cualquier solicitud por el nombre de su comando:

bash
restish p11 discovery-campaigns-list

Para una solicitud que cambia algo, pon el Idempotency-Key primero:

bash
restish p11 inspector-scans-start "$(uuidgen)" url: https://example.com

Vuelve a ejecutar restish api sync p11 para incorporar las solicitudes nuevas.