Inicio rápido

Hay dos formas de autenticarte: un flujo OAuth de un clic, que es el recomendado, o una API key manual.

1. Añade Vibiz a tu cliente

Apunta tu cliente MCP a la URL del servidor Vibiz. Esa es toda la información que cualquier cliente necesita.

https://mcp.vibiz.ai/mcp

• En Claude, usa Settings → Connectors → Add custom connector.
• En Cursor, añádelo en Settings → MCP.
• En Claude Code, ejecuta npx @vibiz/vibiz. Instala el plugin oficial, con comandos de barra, un subagente y un aviso post-commit, y la conexión MCP en un solo paso. Consulta la página de Claude Code.

2. Inicia sesión en Vibiz

Tu cliente abrirá una pestaña del navegador a vibiz.ai. Inicia sesión con la misma cuenta que usas para la app. Aprueba la conexión y el navegador devolverá la sesión a tu cliente.

3. Verifica la conexión

Las herramientas de Vibiz deberían aparecer ahora en el selector de herramientas de tu cliente. Prueba un prompt como "genera una imagen publicitaria para nuestro producto principal" para confirmarlo.

Manual: clave API

¿Prefieres una credencial estática? Genera un token desde la página Developer de tu workspace: inicia sesión en vibiz.ai, luego abre Developer → API keys y añádelo como un encabezado Bearer. Úsalo para agentes sin interfaz, CI o clientes que no admiten OAuth.

{
  "mcpServers": {
    "vibiz": {
      "url": "https://mcp.vibiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VIBIZ_API_KEY"
      }
    }
  }
}

Pruébalo directamente con curl:

curl https://mcp.vibiz.ai/mcp \
  -H "Authorization: Bearer YOUR_VIBIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Conjuntos de herramientas (toolsets)

Una nueva conexión carga el conjunto de herramientas core: anuncios creativos, el informe de crecimiento, configuración de marca, facturación y las lecturas principales. Añade más añadiendo ?toolsets= a la URL del servidor, o con el encabezado X-Vibiz-Toolsets en los clientes que admiten encabezados:

https://mcp.vibiz.ai/mcp?toolsets=ads,social
https://mcp.vibiz.ai/mcp?toolsets=all

Conjuntos de herramientas: core, ads, creatives, social, comms, crm, research, workspace, autonomy, sites. core ya lanza o impulsa anuncios, añade anuncios a un conjunto de anuncios existente y establece su presupuesto; las demás herramientas que gastan en anuncios (volver a activar anuncios, nuevos conjuntos de anuncios, lanzamientos masivos, copias de campañas) están en ads. Cada una de ellas pide tu aprobación antes de gastar. Añade readonly=1 para un conector que solo pueda leer. ¿No estás seguro de cuál necesitas? Pregunta al asistente: la herramienta vibiz_find_capability encuentra cualquier herramienta y nombra el conjunto de herramientas que la habilita.

Próximos pasos