Conectar asistentes de IA

Por qué es importante

MCP (Model Context Protocol) permite que asistentes de IA como Claude interactúen directamente con tu cuenta de Kit: listar ofertas de empleo, consultar plantillas, invitar miembros del equipo y mucho más. En lugar de copiar y pegar entre tu navegador y una ventana de chat con IA, el asistente lee y actúa sobre tus datos reales.

Lo que necesitas

• Una cuenta de Kit — cualquier miembro puede conectarse, no hace falta acceso de administrador
• Un cliente MCP: Claude Desktop, Claude Code, Codex CLI, OpenCode o cualquier aplicación compatible con MCP

Conectar es un acto personal: la conexión es tuya, no de la cuenta. A lo que llega el asistente lo marca tu rol — tus niveles de acceso por módulo, que se releen en cada llamada —, así que dos personas que conecten el mismo cliente a la misma cuenta obtienen conjuntos de herramientas distintos.

Configuración

Ve a Integrations > MCP Setup. Verás la URL de tu servidor MCP y la configuración lista para copiar en cada cliente.

Claude Code (CLI)

Ejecuta esto en tu terminal:

claude mcp add --transport http kit https://startupkit.app/api/v1/mcp

O añádelo a tu archivo de configuración .mcp.json:

{
  "mcpServers": {
    "kit": {
      "type": "http",
      "url": "https://startupkit.app/api/v1/mcp"
    }
  }
}

Claude Desktop

Añade esto a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://startupkit.app/api/v1/mcp"]
    }
  }
}

Claude Desktop usa mcp-remote para gestionar el flujo OAuth a través de un proxy local.

Codex CLI

Registra el servidor y luego autorízalo:

codex mcp add kit --url https://startupkit.app/api/v1/mcp
codex mcp login kit

codex mcp add solo escribe la entrada de configuración: es codex mcp login lo que abre el navegador con la pantalla de consentimiento. Codex habla Streamable HTTP de forma directa, así que no interviene ningún proxy mcp-remote.

La entrada equivalente en ~/.codex/config.toml:

[mcp_servers.kit]
url = "https://startupkit.app/api/v1/mcp"

Si editas el archivo a mano, ejecuta después codex mcp login kit una vez para obtener el token. codex mcp list muestra la conexión y codex mcp logout kit elimina las credenciales.

OpenCode

Añade el servidor a opencode.json, ya sea el archivo global ~/.config/opencode/opencode.json o uno por proyecto en la raíz de tu repositorio:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kit": {
      "type": "remote",
      "url": "https://startupkit.app/api/v1/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

Después, autoriza la conexión:

opencode mcp auth kit

opencode mcp list muestra el estado de autenticación de cada servidor y opencode mcp logout kit borra el token guardado. "oauth": {} indica que este servidor se autentica mediante OAuth; "oauth": false es la opción para servidores que esperan una clave de API fija en headers, algo que Kit no usa.

Flujo de autorización

Cuando tu cliente MCP se conecta por primera vez:

1. Tu navegador abre una página de autorización en Kit
2. Si perteneces a varias cuentas, seleccionas cuál conectar
3. Eliges a qué módulos puede acceder el asistente, y si cada uno es de solo lectura o de lectura y escritura
4. Kit emite un token con alcance limitado a esa cuenta y esos módulos
5. El cliente almacena el token y lo renueva automáticamente

Los tokens expiran después de 2 horas y se renuevan automáticamente. No necesitas volver a autorizar a menos que revoques el acceso.

Ámbitos

El acceso MCP se concede por módulo. Cada módulo tiene un ámbito de lectura y (salvo Compensation Research) un ámbito de escritura:

Módulo	Ámbito de lectura	Ámbito de escritura	Qué abarca
Hiring	hiring_read	hiring_write	Ofertas de empleo, candidaturas, revisiones, bolsa de talento, plantillas y herramientas del portal de empleo
CSiRT	csirt_read	csirt_write	Informes de vulnerabilidades, triaje, mensajes a investigadores, recompensas y configuración del programa
Outreach	outreach_read	outreach_write	Campañas, prospectos, borradores de correo, métricas
Compensation Research	compensation_read	—	Referencias salariales, tendencias del mercado, comparaciones de roles (solo lectura)
Training	training_read	training_write	Programas de formación, diapositivas, cuestionarios, certificaciones, estado de finalización e invitaciones a participantes
Performance	performance_read	performance_write	Ciclos de evaluación, participantes, tus propias evaluaciones y el registro de evaluaciones SOC 2
Team	team_read	team_write	Miembros e invitaciones

El ámbito base mcp se concede siempre. Solo abarca las herramientas globales: búsqueda en la documentación, planes de precios, echo, el saneador de PDF, la investigación de direcciones IP y el verificador de correo.

La pantalla de consentimiento

Cuando autorizas una conexión, la pantalla de consentimiento te guía paso a paso:

1. Elige la cuenta — si perteneces a varias cuentas, elige cuál conectar
2. Elige el acceso por módulo — cada módulo aparece como una fila con un selector Lectura | Lectura y escritura. La escritura está desactivada de forma predeterminada; cambia un módulo a Lectura y escritura solo si el asistente debe realizar acciones, no solo consultar. Los módulos con herramientas de escritura sensibles muestran una advertencia que explica qué estás habilitando.

Los módulos que tu cuenta no tiene quedan ocultos en la pantalla de consentimiento. Los módulos que la cuenta sí tiene pero tú no aparecen atenuados y marcados como fuera de tu rol: ves que existen, pero no puedes concederlos. Kit los descarta en el servidor aunque se envíen de todos modos, así que una conexión nunca puede tener un ámbito al que su propietario no tiene acceso. Para conseguir uno, pide ese módulo a un administrador; la fila enlaza con la solicitud.

Las herramientas de los módulos que no concediste son invisibles para el asistente: nunca aparecen en su lista de herramientas.

Las conexiones autorizadas antes de que existieran los ámbitos por módulo se han desconectado. Vuelve a conectarlas desde la pantalla de consentimiento y elige los módulos que quieras conceder.

Para cambiar lo que puede hacer una conexión, revócala en la página de MCP Setup y conéctala de nuevo: el nuevo consentimiento reemplaza la concesión anterior.

Gestionar clientes conectados

La página de MCP Setup muestra todos los clientes conectados con:

• Nombre de la aplicación — El cliente MCP que se conectó
• Ámbitos — Acceso concedido por módulo, mostrado como chips (R para lectura, RW para lectura y escritura)
• Autorizado el — Cuándo se realizó la conexión
• Último uso — Cuándo el cliente llamó a una herramienta por última vez

Haz clic en Revocar para desconectar un cliente. El cliente necesitará volver a autorizarse para conectarse de nuevo.

Lista de comprobación rápida

• Ve a Integrations > MCP Setup
• Copia la configuración para tu cliente MCP
• Ejecútala o pégala en la configuración de tu cliente
• Autoriza la conexión cuando se abra tu navegador: elige la cuenta y el acceso por módulo (Lectura o Lectura y escritura) en la pantalla de consentimiento
• Prueba con “¿Qué ofertas de empleo tengo?” en tu asistente de IA
• Verifica que la conexión aparezca en los clientes conectados