Guía de integración MCP

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 el estándar que permite a los modelos de IA consultar de forma segura datos de sistemas externos. PJT AI opera su propio servidor MCP remoto por HTTP: sin instalar nada y sin iniciar sesión, basta con registrar la URL y un token para que Claude o Cursor lean directamente los datos de tu espacio de trabajo. Es de solo lectura.

Consulta datos desde Claude Code con estas herramientas:

Herramienta	Descripción
`list_workspaces`	Lista de mis espacios de trabajo (empieza aquí si no sabes el ID)
`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.)

ⓘ

Independiente de la ejecución de trabajo

MCP es solo de lectura y funciona con independencia de la ejecución de tareas (pjt-agent start). La autenticación reutiliza tu token de agente de Claude Code (pjta_…) en la cabecera Authorization: Bearer.

02Conectar Claude Code#

Requisito: solo la CLI claude de Anthropic. No hace falta instalar nada de PJT por npm.

1. Emitir un token

Ve a Configuración → Agentes de Claude Code → «Añadir agente» en tu espacio de trabajo y emite un token (pjta_…). Justo después verás los fragmentos de registro de cada herramienta con el token ya incluido (el token se muestra una sola vez).

2. Registro: una línea

Sustituye pjta_xxx por tu token y pégalo en la terminal.

bash

claude mcp add --transport http pjt-workspace https://mcp.pjt.ai \
  --header "Authorization: Bearer pjta_xxx"

3. Comprobación

bash

$ claude mcp list
pjt-workspace  ✓ connected

$ claude
> muéstrame los documentos recientes de este espacio de trabajo

[pjt-workspace] get_workspace_snapshot → 8 documentos

✓

Conexión correcta

Si claude mcp list muestra pjt-workspace y ves el registro de llamadas a las herramientas en la conversación, la conexión funciona.

03Conectar Cursor#

Añade lo siguiente a ~/.cursor/mcp.json. Usa el mismo token que Claude Code.

json

{
  "mcpServers": {
    "pjt-workspace": {
      "url": "https://mcp.pjt.ai",
      "headers": {
        "Authorization": "Bearer pjta_xxx"
      }
    }
  }
}

ⓘ

Requiere reiniciar

Guarda y reinicia Cursor: las herramientas de pjt-workspace aparecerán en la lista.

04Conectar Codex#

Codex todavía no admite MCP remoto de forma nativa, así que mcp-remote hace de puente. Añádelo a ~/.codex/config.toml.

toml

[mcp_servers.pjt-workspace]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.pjt.ai", "--header", "Authorization: Bearer pjta_xxx"]

ⓘ

Requiere Node.js

El puente se ejecuta con npx, así que necesitas Node.js 18+ en local. Cuando Codex admita MCP remoto, la configuración será tan simple como la de Cursor.

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: vuelve a emitirlo si lo pierdes. Con el modo remoto solo vive en el archivo de configuración de tu cliente; no se instala nada de PJT
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)

Guía de integración MCP

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?#

Consulta datos desde Claude Code con estas herramientas:

Herramienta	Descripción
`list_workspaces`	Lista de mis espacios de trabajo (empieza aquí si no sabes el ID)
`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.)

ⓘ

Independiente de la ejecución de trabajo

02Conectar Claude Code#

Requisito: solo la CLI claude de Anthropic. No hace falta instalar nada de PJT por npm.

1. Emitir un token

2. Registro: una línea

Sustituye pjta_xxx por tu token y pégalo en la terminal.

bash

claude mcp add --transport http pjt-workspace https://mcp.pjt.ai \
  --header "Authorization: Bearer pjta_xxx"

3. Comprobación

bash

$ claude mcp list
pjt-workspace  ✓ connected

$ claude
> muéstrame los documentos recientes de este espacio de trabajo

[pjt-workspace] get_workspace_snapshot → 8 documentos

✓

Conexión correcta

Si claude mcp list muestra pjt-workspace y ves el registro de llamadas a las herramientas en la conversación, la conexión funciona.

03Conectar Cursor#

Añade lo siguiente a ~/.cursor/mcp.json. Usa el mismo token que Claude Code.

json

{
  "mcpServers": {
    "pjt-workspace": {
      "url": "https://mcp.pjt.ai",
      "headers": {
        "Authorization": "Bearer pjta_xxx"
      }
    }
  }
}

ⓘ

Requiere reiniciar

Guarda y reinicia Cursor: las herramientas de pjt-workspace aparecerán en la lista.

04Conectar Codex#

Codex todavía no admite MCP remoto de forma nativa, así que mcp-remote hace de puente. Añádelo a ~/.codex/config.toml.

toml

[mcp_servers.pjt-workspace]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.pjt.ai", "--header", "Authorization: Bearer pjta_xxx"]

ⓘ

Requiere Node.js

El puente se ejecuta con npx, así que necesitas Node.js 18+ en local. Cuando Codex admita MCP remoto, la configuración será tan simple como la de Cursor.

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: vuelve a emitirlo si lo pierdes. Con el modo remoto solo vive en el archivo de configuración de tu cliente; no se instala nada de PJT
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)