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 con acceso de administrador
• Un cliente MCP: Claude Desktop, Claude Code o cualquier aplicación compatible con MCP

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.

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)
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 y el saneador de PDF.

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. 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 los ámbitos por módulo tienen acceso completo; revócalas y vuelve a conectarlas para limitarlas.

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.

En resumen

• 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