Documentación de Kabo MCP

Inicio rápido

Conéctate en unos minutos.

Kabo funciona con clientes que pueden añadir un servidor MCP remoto por HTTP e iniciar sesión con OAuth. Los menús cambian de nombre, pero los pasos son los mismos.

1. Añade un servidor remoto

   Abre los ajustes de MCP o de conectores de tu cliente y añade un servidor con la URL https://kabo.sh/mcp-pub.

2. Inicia sesión en Kabo

   Tu cliente abre la página de inicio de sesión de Kabo en tu navegador. Inicia sesión o crea una cuenta, revisa el acceso que pide Kabo y apruébalo.

3. Consulta las herramientas disponibles

   Pide a tu asistente que llame a get_research_capabilities con un objeto vacío. Indica qué herramientas de datos están listas para tu cuenta sin consumir tu cuota.

{
  "mcpServers": {
    "kabo": {
      "url": "https://kabo.sh/mcp-pub"
    }
  }
}

Si tu cliente usa un archivo JSON, la entrada suele verse así. Los nombres de los campos cambian según el cliente, así que revisa su documentación.

Skills

Agrega Skills a tu conexión MCP.

¿Ya te conectaste? Los diez Skills opcionales de Kabo agregan flujos para revisar cuentas, investigar tendencias y competidores, analizar videos y desarrollar ideas y guiones. Usan tu conexión MCP y tu sesión de Kabo actuales. Conectar MCP no los instala automáticamente.

Kabo Skills se puede usar con agentes compatibles en tu computadora, espacios de trabajo remotos o entornos en la nube. Codex, Claude Code y Cursor son ejemplos, no una lista completa de entornos compatibles.

El entorno del agente debe poder cargar SKILL.md y sus archivos, ejecutar los scripts necesarios con Python 3 y usar tu conexión autorizada a Kabo MCP. La compatibilidad depende de estas capacidades, no de si la interfaz es una aplicación de escritorio o una página web.

Repositorio oficial y README
https://github.com/kabo-sh/kabo-mcp-plugin

Opción 1: Clona el repositorio de GitHub

git clone --branch stable --single-branch https://github.com/kabo-sh/kabo-mcp-plugin.git

Después de clonar, configura el agente para cargar las carpetas completas de Skills desde kabo-mcp-plugin/skills/, o cópialas o impórtalas a la ubicación de Skills que admita. Conserva todos los scripts, referencias y recursos. Clonar por sí solo no registra los Skills en el agente.

Opción 2: Usa skills CLI (npx)

La CLI es un método de instalación opcional. También puedes clonar el repositorio de GitHub o descargar un ZIP. Elige el método que prefieras y que se adapte a tu entorno.

npx skills add 'kabo-sh/kabo-mcp-plugin#stable' --skill '*'

Ejecuta este comando en el directorio de tu proyecto y elige tu agente en el instalador. Por defecto, se instalan en el proyecto actual; agrega -g para usarlos en todos tus proyectos.

Ejemplos de destinos de la CLI: --agent codex, --agent claude-code o --agent cursor. Estos ejemplos no limitan qué agentes pueden usar Kabo Skills.

Revisa la instalación con npx skills list, o con npx skills list -g si es global. Inicia una nueva sesión del cliente para cargar los Skills.

Opción 3: Descarga un ZIP

El ZIP de la versión contiene el plugin completo. Para instalar solo los Skills manualmente, copia cada carpeta completa dentro de skills/ al directorio de Skills de tu cliente, incluidos scripts, referencias y recursos. No basta con copiar SKILL.md. El actualizador de la CLI no registra las copias manuales.

Versiones y actualizaciones

La rama stable sigue las versiones publicadas. Los Skills instalados no se actualizan en segundo plano. Consulta las nuevas versiones y sus notas en GitHub Releases y actualiza cuando lo decidas.

git -C kabo-mcp-plugin pull --ff-only

Para un clon de la rama stable, ejecuta este comando en el directorio que contiene kabo-mcp-plugin. Si copiaste o importaste las carpetas de Skills a otro lugar, reemplaza también esas copias. El actualizador de skills CLI no registra las instalaciones con Git o ZIP.

Para los Skills instalados con skills CLI, elige el alcance de la actualización:

npx skills update -p

npx skills update -g

Estos comandos actualizan todos los Skills registrados en el alcance elegido, incluidos los de otras fuentes. Para actualizar solo Kabo, repite el comando de instalación con el mismo agente y alcance de proyecto o global.

En skills CLI 1.7.4, skills check ejecuta la lógica de actualización y puede reemplazar archivos instalados. Consulta la página de versiones para informarte sin modificar la instalación.

Reemplaza #stable por #v1.0.1 para fijar esa versión. Actualizar una instalación fijada no la cambia a una etiqueta nueva; debes instalar la nueva etiqueta explícitamente.

Consulta los clientes verificados y los requisitos de los flujos en el README. Una instalación correcta no confirma por sí sola un flujo completo.

Herramientas

Las herramientas que tu asistente puede usar.

Consulta las herramientas actuales y sus esquemas de entrada con la solicitud tools/list de tu cliente. Estos son los principales puntos de partida.

El servidor también ofrece herramientas de datos públicos de YouTube, Instagram y TikTok: perfiles, publicaciones, comentarios, transcripciones, búsqueda y tableros de sonidos en tendencia.

Consulta resultados sin reiniciar el trabajo

Para una tarea de datos, pasa su job_id a get_research_data_job. Lee sus archivos con read_research_data_artifacts. Para un análisis de video, pasa el id recibido a get_analysis_run. Consulta el estado de las tareas pendientes en lugar de iniciarlas de nuevo.

Autenticación

Inicia sesión con tu cuenta de Kabo.

Inicio de sesión: OAuth con PKCE y registro dinámico de clientes, sin API key que copiar

Recurso OAuth

https://kabo.sh/mcp-pub

Permisos admitidos

offline_accessopenidprofileemaildatavideoworkspace:readworkspace:write

Metadatos del servidor:

https://kabo.sh/.well-known/oauth-protected-resource/mcp-pub

El recurso OAuth debe coincidir exactamente con el endpoint indicado arriba. Un token emitido para /mcp u otro endpoint no funcionará aquí.

Inicia sesión sin navegador

Si tu cliente MCP se ejecuta donde no puede abrir un navegador ni recibir una redirección de OAuth, como un servidor remoto o una terminal sin interfaz, puede iniciar sesión con el flujo de dispositivo de OAuth (RFC 8628). Usa el ID de cliente fijo que aparece abajo. Los ID de cliente obtenidos con el registro dinámico de clientes no se aceptan para iniciar sesión con dispositivo.

ID de cliente

kabo-mcp-pub

Endpoint de autorización de dispositivo

https://kabo.sh/api/auth/device/code

Página de aprobación

https://kabo.sh/device

curl -X POST https://kabo.sh/api/auth/device/code \
  -H 'content-type: application/json' \
  -d '{"client_id":"kabo-mcp-pub","scope":"openid offline_access data video"}'

curl -X POST https://kabo.sh/api/auth/oauth2/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=DEVICE_CODE \
  -d client_id=kabo-mcp-pub

La respuesta incluye un user_code y un enlace verification_uri_complete. Abre el enlace en cualquier dispositivo, inicia sesión en Kabo y comprueba que el código coincida. Mientras tanto, consulta el endpoint de tokens con el intervalo indicado hasta que devuelva un token de acceso en lugar de authorization_pending. El scope debe incluir offline_access y puede incluir cualquiera de los scopes admitidos de arriba. El token solo funciona en el endpoint del servidor indicado arriba; renuévalo con el token de actualización.

El código de dispositivo vence a los 15 minutos (expires_in en la respuesta). No consultes más rápido que interval, que es de 5 segundos; si el servidor devuelve slow_down, suma 5 segundos. authorization_pending significa que debes seguir consultando con el mismo código. expired_token significa que el código venció: solicita uno nuevo. access_denied significa que el usuario lo rechazó: detente y no vuelvas a intentarlo por tu cuenta. Mientras un código siga vigente, no solicites otro: cada solicitud crea un código nuevo y solo el que el usuario aprueba inicia sesión.

El inicio de sesión con dispositivo no usa el parámetro resource. Los tokens emitidos para kabo-mcp-pub siempre quedan vinculados al endpoint del servidor indicado arriba.

Permisos y lo que habilitan

Solicita solo lo que la tarea necesita. Cada herramienta comprueba un permiso, y si falta devuelve 403 insufficient_scope con su nombre.

offline_access

Necesario para obtener un token de actualización. Sin él, la sesión termina cuando vence el token de acceso de 2 horas. Obligatorio para iniciar sesión con dispositivo.

openidprofileemail

Solo identidad de inicio de sesión, sin acceso a herramientas. profile agrega tu nombre y foto, y email agrega tu correo, a get_kabo_info.

data

Datos públicos de investigación: herramientas de tendencias y búsqueda, trabajos de datos y get_research_capabilities.

video

Análisis de videos guardados y remakes de video. Iniciar un análisis nuevo requiere Kabo Pro y tu aprobación.

workspace:read

Leer tu espacio de trabajo de Kabo: tu información de Kabo, cuentas conectadas, perfil de creador, guiones y biblioteca de videos.

workspace:write

Guardar y actualizar guiones, y conectar cuentas públicas de creador.

Mantén la conexión entre tareas

Los tokens de acceso duran 2 horas. Los tokens de actualización duran 30 días y se renuevan en cada uso, así que cada uno funciona una sola vez. Guárdalos en el almacenamiento seguro de credenciales del host, nunca en la conversación ni en registros comunes, y renueva desde un solo lugar a la vez: reutilizar un token de actualización antiguo cierra todas las sesiones de ese cliente en la cuenta. Terminar una tarea no tiene por qué cerrar la sesión. Si tu entorno no puede conservar credenciales después de una tarea, avísale al usuario antes de iniciar sesión que tendrá que volver a iniciarla la próxima vez.

Uso y acceso

Conectarse es gratis. Las consultas de datos públicos pueden consumir la cuota diaria de tu cuenta. Iniciar un nuevo análisis guardado de video requiere Kabo Pro y tu aprobación. Consultar disponibilidad y resultados no consume la cuota de datos.

¿Qué puede ver mi asistente a través de Kabo?

La evidencia pública de creadores que Kabo reúne para tu petición, además de los análisis y trabajos de investigación que inicias con tu propia cuenta de Kabo. Kabo no puede leer los trabajos de otros usuarios ni los mensajes privados, borradores o estadísticas privadas de nadie.

No. Kabo investiga y analiza. No publica, no comenta, no envía mensajes ni edita contenido en ninguna plataforma.

Solución de problemas

Resuelve los problemas de conexión.

Los agentes que se conectan a Kabo deben seguir estas reglas.

1. Comprueba antes de iniciar sesión

   Usa primero la conexión existente y vuelve a iniciar sesión solo cuando el servidor devuelva 401. Para comprobarla sin usar tu cuota, llama a get_research_capabilities o get_kabo_info.

2. Pide lo que la tarea necesita

   Solicita data para datos de investigación, video para análisis de videos guardados y workspace:read o workspace:write para el espacio de trabajo de Kabo. No pidas todos los permisos por defecto ni omitas uno que la tarea necesite.

3. Ajusta la solución al error

   401: inicia sesión. 403 insufficient_scope: vuelve a autorizar con el permiso indicado en el error. invalid_client: revisa el ID de cliente. Los errores de cuota, suscripción, límite de frecuencia o concurrencia no son problemas de inicio de sesión, así que no le pidas al usuario que vuelva a iniciarla.

4. Tras un tiempo de espera agotado, comprueba antes de repetir

   Es posible que la solicitud ya se haya ejecutado. Revisa primero su resultado. Las herramientas de guardar y actualizar aceptan una clave de idempotencia, así que repetir la misma solicitud es seguro.

5. Usa un solo código de dispositivo

   Mientras un código de dispositivo siga vigente, sigue consultándolo en lugar de solicitar uno nuevo.

6. Las Skills no son una conexión

   Que las Skills de Kabo estén cargadas no significa que el servidor MCP de Kabo esté conectado, y actualizar un plugin no actualiza las herramientas de la sesión actual. Comprueba que las herramientas de Kabo aparezcan antes de usarlas.