Skip to content
Documentación

Servidor MCP

The full contract lifecycle, run from Claude over MCP

El servidor MCP de Contracko conecta tu espacio de trabajo de contratos con el asistente de IA que ya usas. Pregunta a Claude, ChatGPT, Gemini o Copilot sobre tus contratos y leerán los registros reales: partes, fechas, valores y los propios documentos. Dales acceso de escritura y podrán importar contratos, configurar recordatorios y archivar nuevos acuerdos por ti.

Tú mantienes el control. Lectura y escritura son permisos independientes, tú eliges cuáles conceder, y puedes desconectar en cualquier momento.

Conéctate en dos pasos

  1. Añade las skills para que el asistente sepa cómo ayudarte con los contratos. Las skills son cuatro guías breves publicadas en contracko/contracko-skills.
  2. Añade la conexión para que pueda acceder a tu espacio de trabajo. Pega esta dirección cuando te la pida:
https://app.contracko.com/mcp

Se abrirá una ventana del navegador. Inicia sesión en Contracko, o empieza una prueba gratuita desde esa pantalla si aún no tienes cuenta.

Añadir las skills no conecta tu espacio de trabajo por sí solo. Si Contracko ya aparece en la lista de conectores de tu asistente, omite el paso 2 en lugar de añadirlo de nuevo. ¿Usas Claude o Claude Code? Sigue en su lugar los pasos de Claude en Conecta tu asistente: Contracko está en el directorio de conectores de Claude.

Al iniciar sesión, marca Lectura para que el asistente pueda responder preguntas. Marca Escritura solo si debe añadir o modificar contratos. Deja Escritura desactivada a menos que quieras eso.

Elige acceso de lectura o escritura

PermisoQué permiteCuándo concederlo
LecturaBuscar contratos, leer fechas, valores y partes extraídos, buscar dentro de los documentos, ver el análisis de IA y los comentariosSiempre. Es suficiente para hacer preguntas sobre tu espacio de trabajo.
EscrituraImportar contratos, actualizar campos, añadir documentos y comentarios, crear tipos de contrato y contrapartes, crear, cambiar el nombre y mover carpetas, archivar contratos en las carpetas que puedes ver, configurar y cambiar recordatoriosSolo cuando quieras que el asistente haga cambios. Empieza sin él.

Con Lectura, el asistente también puede mostrarte quién tiene acceso a un contrato o una carpeta. También puedes limitar las búsquedas de contratos a una carpeta que puedes ver. Los cambios de acceso y la eliminación de carpetas se hacen solo en la aplicación de Contracko. Pide al asistente que confirme los cambios propuestos antes de realizarlos. Actúa como tú, así que solo puede acceder a contratos y carpetas a los que tú puedes acceder dentro de los permisos de tu espacio de trabajo. Consulta permisos de contratos para saber cómo se decide el acceso.

Esto es distinto de Clara AI, que funciona dentro de Contracko. Usa Clara en la aplicación, y conecta por MCP cuando quieras trabajar desde Claude, ChatGPT u otro asistente que ya tengas abierto.

Encuentra los contratos que necesitas

Pide un proveedor, tipo de contrato, estado, intervalo de fechas de finalización o intervalo de fechas de preaviso. Tu asistente puede acotar la lista de contratos antes de leer los resultados. Por ejemplo: «¿Qué contratos de Acme vencen o requieren preaviso el próximo trimestre?». Si varios proveedores tienen el mismo nombre, confirma cuál quieres.

Tu asistente debe revisar cada página de contratos coincidentes antes de informar que el resultado está completo. Las búsquedas por fecha excluyen los contratos sin una fecha coincidente, así que pide las fechas que faltan por separado. Una fecha de finalización por sí sola no significa que un contrato se renueve automáticamente. Las preguntas sobre importes, monedas, campos ausentes o cláusulas pueden requerir más comprobaciones.

Usa tu conexión actual

OAuth es la forma predeterminada de conectar Contracko con tu asistente. No necesitas una conexión nueva, una clave de API de reemplazo ni permisos adicionales para usar una búsqueda mejorada en las herramientas que ya tienes. Si tu asistente aún muestra opciones antiguas, actualiza sus herramientas o vuelve a conectar el conector existente.

Si OAuth no está disponible, puedes usar una clave de API de MCP dedicada. Envíala con cada solicitud en la cabecera Authorization: Bearer <tu-clave-de-API-de-MCP>. Guarda la clave de forma segura y no la compartas.

Las acciones disponibles dependen de tu conexión y de los permisos del espacio de trabajo. Mantén Lectura para las preguntas. Concede Escritura solo si quieres que el asistente haga cambios. Si falta una acción, revisa el espacio de trabajo seleccionado y los permisos de la conexión, o contacta con soporte.

Comprueba los cambios inciertos antes de volver a intentarlo

Si tu asistente no puede confirmar si un cambio se realizó correctamente, revisa el contrato en Contracko antes de volver a intentarlo. Un error no siempre significa que no se haya cambiado nada.

Los agentes y desarrolladores pueden consultar los argumentos de las herramientas y las indicaciones para procesar respuestas en las instrucciones de configuración para agentes.

Conecta tu asistente

Elige el producto que usas. Todas las rutas terminan igual: inicia sesión en la ventana del navegador que se abre.

Claude

Para Claude en la web, el escritorio, el móvil y Cowork.

  1. Abre Contracko en el directorio de conectores de Claude.
  2. Elige Connect to Claude.
  3. Inicia sesión en Contracko en el navegador que se abre.

Funciona en todos los planes de Claude, incluido Free. En Team y Enterprise, un Owner tiene que activarlo primero. Un conector que añadas en la web o en el escritorio también funciona en la app móvil de Claude.

Desde Pro también puedes instalar el plugin Contracko (Customize → Plugins) para las cuatro skills de contratos y luego conectar desde su pestaña Connectors.

¿Añadiste Contracko antes como conector personalizado? Elimínalo, o verás cada herramienta dos veces.

ChatGPT

  1. Ve a Settings → Plugins → Import marketplace e introduce contracko/contracko-skills.
  2. Activa el Developer mode.
  3. Ve a Settings → Apps → Create y pega https://app.contracko.com/mcp.
  4. Inicia sesión en el navegador que se abre.

Grok

  1. Abre grok.com/connectors.
  2. Añade https://app.contracko.com/mcp.
  3. Inicia sesión en el navegador que se abre.

Claude Code

¿Has iniciado sesión con tu cuenta de Claude? Un conector añadido en Claude ya está disponible aquí, así que no hay nada que añadir.

Para las skills, instala el plugin. También registra la conexión:

/plugin marketplace add https://github.com/contracko/contracko-skills.git
/plugin install contracko@contracko

Usa la dirección completa de GitHub, no un nombre corto tipo owner/repo. Después escribe /mcp en la sesión e inicia sesión.

¿Usas una clave de API sin el plugin? Ejecuta esto solo si claude mcp list no muestra ninguna entrada de Contracko:

claude mcp add --transport http contracko https://app.contracko.com/mcp

Después escribe /mcp e inicia sesión.

Codex

npx skills@latest add contracko/contracko-skills
codex mcp add contracko --url https://app.contracko.com/mcp
codex mcp login contracko

Cursor

npx skills@latest add contracko/contracko-skills

Después añade esto a .cursor/mcp.json en tu proyecto, creando el archivo si no existe:

{ "mcpServers": { "contracko": { "url": "https://app.contracko.com/mcp" } } }

Reinicia Cursor si no detecta la conexión.

GitHub Copilot en VS Code

npx skills@latest add contracko/contracko-skills

Después añade esto a .vscode/mcp.json:

{ "servers": { "contracko": { "type": "http", "url": "https://app.contracko.com/mcp" } } }

Gemini CLI

npx skills@latest add contracko/contracko-skills

Después añade esto a ~/.gemini/settings.json:

{ "mcpServers": { "contracko": { "httpUrl": "https://app.contracko.com/mcp" } } }

OpenClaw

npx skills@latest add contracko/contracko-skills
openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko

Hermes

npx skills@latest add contracko/contracko-skills

Después añade esto a ~/.hermes/config.yaml:

mcp_servers:
  contracko:
    url: "https://app.contracko.com/mcp"
    auth: oauth

Ejecuta hermes mcp login contracko e inicia sesión.

Cualquier otro asistente

Pega esto en el asistente y deja que siga las instrucciones:

Fetch and execute https://contracko.com/mcp/install/prompt.md

Si prefieres añadir la conexión tú mismo, la dirección sigue siendo https://app.contracko.com/mcp.

Prueba a preguntar

Una vez conectado, habla con el asistente como lo harías con un compañero de trabajo.

Prueba a preguntarQué hace
Estamos haciendo el onboarding. Importa todos los PDF de esta carpeta a Contracko.Encuentra los archivos, revisa el conjunto contigo, los importa y deja que Contracko extraiga fechas, partes y tipos.
No quiero renovaciones silenciosas. ¿Qué necesita preaviso, vence o se renueva automáticamente en el próximo trimestre? Configura recordatorios para todo eso.Enumera las fechas importantes y luego crea recordatorios para avisarte a tiempo.
Compara el MSA de Acme con el de Beta. ¿Quién tiene mejor límite de responsabilidad, terminación y condiciones de tratamiento de datos?Pone ambos registros lado a lado, con las cláusulas citadas.
Audita nuestros contratos con proveedores en busca de responsabilidad ilimitada, indemnizaciones unilaterales y plazos de preaviso ausentes.Recorre la cartera y cita la frase detrás de cada hallazgo.
Nuestro archivo es un caos. Ayúdame a acordar una estructura de carpetas para MSA, NDA, SOW y DPA, créala después y archiva nuestros contratos en ella.Confirma la estructura contigo, crea después las carpetas y archiva los contratos a los que puedes acceder. También define los tipos, campos y contrapartes que usas.
¿A qué deberíamos prestar atención este mes? ¿Qué es urgente y qué se nos está pasando?Clasifica el espacio de trabajo por urgencia y vacíos.
Guíame en una nueva NDA, envíala a firmar y archiva el PDF firmado cuando vuelva.Ejecuta el cuestionario y luego archiva la copia ejecutada.

No necesitas nombrar una skill. Basta con preguntar en lenguaje natural.

Qué hace cada skill

SkillÚsala para
contrackoConectar y luego organizar tipos de contrato, campos personalizados, contrapartes y carpetas
contracko-importTraer PDF y archivos de Word desde el disco, Drive, SharePoint, Box o un enlace
contracko-reviewFechas de preaviso, recordatorios, comparaciones, lenguaje de riesgo y qué revisar a continuación
contracko-createUn nuevo acuerdo, desde las preguntas hasta el archivo del PDF firmado

Conéctate con un token en su lugar

Usa el inicio de sesión en el navegador (OAuth) para la mayoría de las conexiones. Si tu cliente o automatización no puede usarlo, crea una clave de API de MCP dedicada en Contracko: Settings → Integrations → API keys. Configura el cliente para enviarla como cabecera Authorization: Bearer a https://app.contracko.com/mcp. Guarda la clave en la configuración de secretos del cliente, no en chats ni archivos compartidos. Ambos métodos de conexión respetan el acceso que concedes y los permisos de tu espacio de trabajo.

Gestiona las conexiones en Contracko

Cuando apruebas el acceso, el asistente aparece en MCP Connections, en Settings → Integrations. Puedes ver quién lo conectó, qué acceso tiene y cuándo se usó por última vez.

Puedes desconectar cualquier conexión de la lista. Solo quien la conectó puede aprobar acceso OAuth adicional. Solo los propietarios y los admins pueden crear, cambiar o revocar API keys.

Ver una conexión

  1. Abre Settings y luego Integrations.
  2. Encuentra el asistente en MCP Connections.
  3. Abre el menú de la fila y elige Manage connection.

El cuadro muestra Connected by, Last used y Current access.

Desconectar un asistente

  1. Elige Disconnect en el menú de la fila, o abre Manage connection y usa el control para desconectar.
  2. Confirma Disconnect.

Ese asistente pierde el acceso a este espacio de trabajo. El resto de conexiones no cambia. Quita también el conector en el asistente, o te pedirá iniciar sesión otra vez.

Cambiar el acceso o rotar la autorización

No puedes cambiar los permisos OAuth en esta pantalla. Para cambiar Read o Write, vuelve a conectar desde el asistente y aprueba los permisos otra vez.

  1. En Contracko, abre Manage connection y elige Connection setup si necesitas la dirección MCP o los pasos del cliente.
  2. En el asistente, vuelve a conectar Contracko e inicia sesión.
  3. En la pantalla de aprobación, marca Read. Marca Write solo si el asistente debe cambiar contratos.
  4. Elige Disconnect en la conexión que ya no uses, para que el mismo asistente no aparezca dos veces.

Volver a conectar es también cómo se rota la autorización OAuth. No hay un botón aparte para rotar el token.

Rotar o revocar una clave de API

Las conexiones con token se gestionan en API keys de la misma página, no en MCP Connections.

  1. Crea una clave MCP server nueva si sigues necesitando un token. Copia el secreto una sola vez.
  2. Pon el secreto nuevo en la cabecera Authorization: Bearer del cliente.
  3. Abre la clave antigua y elige Revoke key.

Manage key puede añadir acceso sin cambiar el secreto. Las claves caducan a los 12 meses.

Soluciona problemas comunes

"Your Contracko connection needs to be renewed." La conexión ha caducado. Vuelve a conectar desde la configuración de conectores de tu asistente e inicia sesión de nuevo.

El asistente dice que no encuentra una herramienta. Comprueba el espacio de trabajo seleccionado y los permisos de la conexión, y luego actualiza las herramientas del asistente. Concede Escritura solo si quieres que haga cambios. Contacta con soporte si la acción sigue sin aparecer.

El asistente no puede ver un contrato que tú sí ves. Comprueba que has iniciado sesión en el espacio de trabajo correcto y que el contrato está compartido contigo en Contracko.

Contracko aparece dos veces. Tienes dos conexiones al mismo servidor. En Claude, elimina el conector personalizado que añadiste antes y quédate con el del directorio de conectores. En Claude Code, si instalaste el plugin y además ejecutaste claude mcp add, ejecuta claude mcp remove contracko. En otros asistentes, elimina el conector duplicado. Añadir las skills y añadir la conexión son pasos independientes, y añadir la conexión dos veces crea dos entradas.

Antes de compartir contratos reales

Contracko no entrena modelos con tus contratos, y nuestro análisis funciona bajo condiciones comerciales de API con retención de datos cero cuando está disponible.

Conectar un asistente es diferente. Cuando Claude, ChatGPT u otro producto llama a Contracko, el texto de tu contrato se envía a ese producto, y Contracko no puede controlar qué ocurre con él allí. Desactiva el entrenamiento de modelos en ese producto antes de usarlo con contratos reales. Consulta Seguridad para saber cómo tratamos tus datos por nuestra parte.

Obtén ayuda

Para preguntas sobre Contracko en sí, lee la documentación o contáctanos.

Para una pregunta sobre las skills, una sugerencia o una mejora, abre un issue en el repositorio de las skills.

Si quieres la versión legible por máquina de esta documentación para un agente o un rastreador, consulta herramientas para agentes.