plnnrlydevelopers

Tu cliente de IA, que actúa como tú.

Conecta Claude, ChatGPT, Cursor o Gemini a tu organización de plnnrly, o llama a la API REST desde tu propio código. Ambos actúan en tu nombre, con tus permisos.

¿Creas una integración? Empieza por la API REST

https:///mcp/v1

Escribe la dirección con la que inicias sesión en plnnrly, por ejemplo acme.plnnrly.com. El panel de IA de plnnrly (el icono de destellos en la barra superior) muestra la URL exacta.

¿Dónde encuentro mi URL?

Escribe la dirección con la que inicias sesión en plnnrly, por ejemplo acme.plnnrly.com. El panel de IA de plnnrly (el icono de destellos en la barra superior) muestra la URL exacta.

Después, añádela a tu cliente

Un conector personalizado en tu cuenta de Claude. Después también funciona en Claude Desktop y en las aplicaciones móviles.

  1. En Claude, abre Customize › Connectors y elige Add custom connector.
  2. Escribe plnnrly como nombre y pega la URL del servidor.
  3. Haz clic en Add, inicia sesión en plnnrly y haz clic en Aprobar.
Guía completa para claude.ai

El mismo conector que en claude.ai. Si lo añadiste allí, ya está aquí.

  1. En Claude Desktop, abre Customize › Connectors y elige Add custom connector.
  2. Escribe plnnrly como nombre y pega la URL del servidor.
  3. Haz clic en Add. Se abre una ventana de plnnrly en tu navegador: inicia sesión y haz clic en Aprobar.
Guía completa para Claude Desktop

Ejecuta esto en tu terminal y luego inicia sesión con claude mcp login plnnrly.

Terminal
claude mcp add --transport http plnnrly https://<tu-url>/mcp/v1
Guía completa para Claude Code

ChatGPT en la web añade plnnrly como servidor MCP personalizado.

  1. Abre chatgpt.com/plugins y elige + y después Add custom MCP server.
  2. Pega la URL del servidor en Connection y elige OAuth.
  3. Crea e instala el plugin. Después inicia sesión en plnnrly y haz clic en Aprobar.
Guía completa para ChatGPT

Añade esta entrada a ~/.cursor/mcp.json. Cursor te pide iniciar sesión en plnnrly cuando se conecta.

~/.cursor/mcp.json
{
  "mcpServers": {
    "plnnrly": {
      "url": "https://<tu-url>/mcp/v1"
    }
  }
}
Guía completa para Cursor

Ejecuta esto en tu terminal, inicia gemini e inicia sesión con /mcp auth plnnrly.

Terminal
gemini mcp add --transport http --scope user plnnrly https://<tu-url>/mcp/v1
Guía completa para Gemini
Otros clientes

Qué pasa cuando preguntas

Preguntas

¿Cuáles de mis elementos de trabajo siguen abiertos?

Herramienta
api_read
Petición
GET /work-itemsfilter[assignee_id]=mefilter[resolved]=false
Comprobado
Respuesta
200 OKTus elementos de trabajo abiertos, página a página

Las mismas comprobaciones que la API REST. Un cliente nunca hace más de lo que puedes hacer tú.

Qué puede hacer el servidor

No hay una herramienta por función: un cliente busca la operación que necesita, lee lo que acepta y la llama en tu nombre. Todo está a su alcance, salvo subir archivos.

  • search_api

    Encuentra la operación de la API para una tarea y muestra lo que acepta.

    Lee la documentación, no tus datos

  • api_read

    Lee todo lo que la API REST puede leer.

    Tus permisos de lectura

  • api_write

    Crea y cambia datos. Solo elimina si tu organización lo permite y tú lo confirmas.

    Tus permisos de escritura; pregunta antes de eliminar

  • get-current-user-tool

    Devuelve tu propio perfil.

    Tu propio perfil

Cómo funcionan las herramientas

Antes de conectar

En las organizaciones nuevas, MCP está desactivado. Un administrador lo activa, y solo funciona mientras la API REST está activada.

AjustePor defectoQué hace
Activar la API RESTActivadoPermite llamar a la API REST con tokens de API propios, y que las aplicaciones inicien la sesión de cada persona con OAuth.
Activar MCPDesactivadoPermite conectar un cliente de IA, como Claude o ChatGPT, iniciando sesión. El cliente trabaja a través de la API REST, en nombre de quien lo conectó.Necesita Activar la API REST.
Permitir acciones destructivasDesactivadoPermite que un cliente de IA conectado elimine lo que la API REST puede eliminar, dentro de los permisos de la persona y solo después de que lo confirme.Necesita Activar MCP.

Configuración › Administración › MCP & API

Para administradores

¿Prefieres código?

La API REST lee y cambia proyectos, elementos de trabajo, horas, documentos de Drive, clientes, facturas, ausencias y planificación. Cada operación indica qué permisos del token y qué permiso de rol necesita.

  1. Crea un token: menú de usuario › Acceso a la API › Crear token.
  2. Tu URL base es https://<tu-url>/api/v2/.
  3. Primera llamada: GET /api/v2/ muestra lo que expone tu organización.

Tu primera llamada a la API (en inglés)

La referencia describe 228 operaciones, generadas a partir del código de plnnrly en cada versión.

Terminal
curl https://<tu-url>/api/v2/ \
  -H "Authorization: Bearer <token>"

Guías

Para empezar

Trabajar con datos

Cuando algo falla