Cómo conectar Claude, Cursor y otras apps de IA con MCP
Cada workspace tiene un servidor MCP. Apps de IA como Claude, Claude Code, Cursor, Codex y Gemini CLI se conectan con una clave personal y después leen y actualizan tu trabajo como tú, con tus permisos. Por qué es útil lo explica MCP en Worknano. Esta página es la configuración.
Actívalo (admins)
- Abre Organización y haz clic en Settings. En MCP Server, activa Enable MCP Server. Sigue apagado hasta que un admin lo active.
- Abre Config, haz clic en Integrations y luego en MCP Server. Cada app (Claude, Cursor, Codex, Gemini) es una plantilla de conexión. Si apagas una plantilla, dejan de funcionar todas las claves creadas a partir de ella.
- Elige qué modelos puede leer, crear o actualizar cada plantilla. Borrar está desactivado por defecto.
- En Permissions, MCP Permissions define qué pueden hacer las conexiones externas en todo el workspace. Consulta Permisos.
- Por defecto, pueden conectar Founders y Heads. Para que otros roles conecten, dales permiso de creación sobre MCP Connection en Permissions.
Conecta tu app
- Abre My y haz clic en Integrations. Busca Worknano in other AI apps.
- Haz clic en Connect junto a tu app. La fila muestra la Server URL y tu clave.
- Copia la Server URL. Es la dirección de tu workspace con /mcp al final, por ejemplo https://yourcompany.worknano.com/mcp.
- Muestra y copia la clave. Empieza por wnpat_. Solo tú puedes verla, y cada vez que se muestra queda registrado.
- Sigue la guía de la fila de tu app. Todas las apps necesitan lo mismo: la Server URL y una cabecera Authorization con el valor Bearer seguido de tu clave.
Claude Code, con un solo comando:
claude mcp add --transport http --scope user worknano https://yourcompany.worknano.com/mcp --header "Authorization: Bearer YOUR_KEY"
Cursor, en ~/.cursor/mcp.json:
{ "mcpServers": { "worknano": { "url": "https://yourcompany.worknano.com/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }
Gemini CLI usa httpUrl en lugar de url. Codex necesita Streamable HTTP y la misma cabecera. En la app de Claude, añade un conector personalizado, elige No sign in y añade la cabecera. Un conector que un owner añade para todo un equipo de Claude envía la misma clave para todos, con los permisos de esa clave.
Qué puede hacer la app
- Leer el workspace: modelos, campos, registros, recuentos y agrupaciones.
- Crear y actualizar registros en los modelos que permite tu plantilla.
- Listar, leer y guardar archivos (HTML, texto y tableros).
- Proponer cambios de config como borradores. Nada cambia hasta que un admin aprueba el borrador en Worknano.
Cada llamada tiene tres límites: los ajustes MCP del modelo, los permisos de tu conexión y tu propio rol. Secrets, usuarios, roles e integraciones nunca quedan expuestos.
Claves, caducidad y desconexión
- Una clave dura 90 días. Cuando caduca, la fila muestra Not connected. Haz clic en Connect para obtener una nueva y pégala en tu app.
- Haz clic en Disconnect para borrar tu clave. La app pierde el acceso al instante.
Worknano también puede usar otros servidores MCP dentro de sus propios asistentes. Es el MCP Client, un interruptor aparte junto a Enable MCP Server. Llamar a Worknano desde tu propio código está en la documentación para desarrolladores. Vuelve al mapa de docs.