Lleva tu contexto a las herramientas de desarrollo con IA
Consulta el contexto de proyecto de PJT AI directamente desde Claude Code · Cursor · Codex.
01¿Qué es MCP?#
MCP (Model Context Protocol) es un estándar que permite a los modelos de IA consultar de forma segura datos de sistemas externos. PJT AI ofrece un servidor MCP por stdio (pjt-agent-mcp) en el paquete @apexstack/agent. Claude Code en tu equipo puede consultar directamente los datos del espacio de trabajo, y es de solo lectura.
Consulta datos desde Claude Code con estas herramientas:
| Herramienta | Descripción |
|---|---|
get_project | Datos básicos del proyecto (id o publicId p_xxx) |
list_project_tasks | Lista de tareas (con filtro por estado) |
get_task | Detalle de la tarea |
get_document | Detalle del documento (incluye content) |
list_workspace_documents | Lista de documentos del espacio |
get_workspace_snapshot | Paquete del espacio (documentos recientes, etc.) |
pjt-agent start) y funciona sin start. La autenticación reutiliza tal cual tu token de agente de Claude Code (pjta_…).02Conectar Claude Code#
Requisito: deben estar instalados localmente Node.js 18+ y la CLI claude de Anthropic.
1. Emitir un token
Emite un token (pjta_…) desde Ajustes → Agente de Claude Code → «Añadir agente» del espacio. Justo después de emitirlo, el comando de registro se muestra con el token ya rellenado (el token solo se muestra una vez). Usa el mismo token que el agente de ejecución de trabajo.
2. Instalar
npm install -g @apexstack/agent
3. Registrar — una línea (recomendado)
Inyecta el token y la URL mediante --env sin iniciar sesión y queda en una sola línea.
claude mcp add pjt-workspace \ --env PJT_AGENT_TOKEN=pjta_xxx \ --env PJT_API_URL=https://api.pjt.ai \ -- pjt-agent-mcp
O bien regístralo de forma más breve tras login (guarda un archivo de token):
pjt-agent login --token pjta_xxx claude mcp add pjt-workspace -- pjt-agent-mcp
4. Comprobar que funciona
$ claude > Muéstrame los documentos recientes de este espacio [pjt-workspace] get_workspace_snapshot → 8 documentos [Claude] Estos son los 8 documentos más recientes: 1. Brief de la campaña de primavera (06/07) 2. ...
pjt-workspace aparece en claude mcp list y los registros de llamadas a las herramientas anteriores aparecen en la conversación, funciona.03Cursor (próximamente)#
04Codex (próximamente)#
05Alcance del contexto#
Por defecto, MCP expone solo el contexto de los proyectos de los que el usuario es miembro. El control más detallado es posible así:
| Alcance | Por defecto | Cómo controlarlo |
|---|---|---|
| Por proyecto | Según la pertenencia | Ajustes del espacio > Permisos |
| Campos sensibles | Incluye presupuestos y cotizaciones | Se pueden excluir en ajustes |
| Notas de reunión | Texto completo expuesto | Opción de exponer solo el resumen |
06Seguridad · permisos#
- Solo lectura — con MCP no se pueden modificar/eliminar datos (solo consulta)
- Reutiliza el token de agente de Claude Code (pjta_) — sin clave aparte; se revoca/reemite por agente
- El token se muestra una sola vez al emitirlo — reemítelo si se pierde. En local está en ~/.pjt/agent.json (permiso 0600)
- Cifrado en tránsito y en reposo (TLS 1.3 + AES-256); todos los accesos se registran en los logs de auditoría
- No se usa para entrenar IA — la propiedad de los datos sigue siendo del espacio
- Enterprise puede elegir SSO/SAML y residencia de datos (US · EU · KR)