Desarrolladores
Plur-e para desarrolladores — conecta clientes de IA por MCP o llama a la API REST pública de Plur-e con una clave de API del tenant para leer y escribir Business Central, Dynamics 365 CRM y el panel móvil.
Respuesta rápida
La sección Developers del Admin Center tiene dos partes: AI & MCP, para conectar
asistentes de IA a Business Central y Dynamics 365 CRM, y APIs, una API REST pública para
tus propias integraciones. La API está en https://api.plur-e.com/api/public/v1, responde
JSON y se autentica con una clave de API del tenant enviada como Authorization: Bearer plrapi_…. Requiere el módulo Developer APIs en tu suscripción; cada clave lleva scopes y
los mismos roles que gobiernan MCP, así que nunca puede hacer más de lo que permitas.
Qué obtienes
| Parte | Qué es | Dónde empezar |
|---|---|---|
| AI & MCP | Servidores MCP remotos para asistentes de IA, gobernados por roles MCP | Servidores MCP de Plur-e |
| APIs | API REST pública para scripts, servicios de back-end e integraciones | Esta sección |
La API tiene tres áreas, todas bajo la misma URL base:
| Área | Ruta | Qué hace |
|---|---|---|
| Business Central | /bc | Ejecuta los métodos catalogados de Business Central y consultas OData de solo lectura |
| Dynamics 365 CRM | /crm | Lee, crea, actualiza y elimina registros de Dataverse, y ejecuta acciones |
| Panel de Plur-e | /panel | Lee usuarios móviles, dispositivos, ubicaciones, actividad, roles y módulos |
Autenticación
La cabecera bearer, los mensajes 401, la revocación y los límites de tasa.
Claves de API
Crea una clave, elige scopes y roles, define la caducidad.
Business Central
Métodos, consultas y los borrados que la API rechaza.
Dynamics 365 CRM
Registros, estado, asignación, FetchXML, búsqueda y acciones.
Panel de Plur-e
Usuarios móviles, dispositivos, ubicaciones, actividad, roles y módulos.
Errores
El formato problem+json y todos los códigos de error.
Requisitos
- El módulo Developer APIs licenciado en tu suscripción de Plur-e. Sin él, crear una clave responde el error 1320 y cada llamada a la API se rechaza con el mismo error. Listar y revocar claves sigue funcionando para que puedas limpiar.
- Un administrador del tenant para crear claves (el rol
admindel tenant). El personal de soporte puede ver las claves, pero no crearlas ni revocarlas. - Para Business Central: el entorno y la compañía de Business Central configurados en Developers → AI & MCP → Settings. La API usa siempre ese entorno y esa compañía; no puedes elegir otros por petición.
- Para Dynamics 365 CRM: un CRM conectado en Developers → AI & MCP → Dynamics 365 CRM. Una clave queda ligada a una conexión de CRM.
URL base y formato
https://api.plur-e.com/api/public/v1- Las peticiones y respuestas son JSON. Los nombres de propiedad van en
camelCase. - Cada petición necesita la cabecera
Authorization: Bearer <YOUR_API_KEY>. Consulta Autenticación. - Los errores usan
application/problem+json. Consulta Errores. - La API lleva la versión en la ruta (
v1). Las llamadas tienen límite de tasa por clave; consulta Autenticación.
Tu primera llamada
Lista los métodos de Business Central que tu clave puede ejecutar:
curl -s "https://api.plur-e.com/api/public/v1/bc/methods" \
-H "Authorization: Bearer <YOUR_API_KEY>"Una respuesta 200 es un array JSON. Una respuesta 401 significa que la clave es incorrecta,
está revocada o ha caducado; el campo detail indica cuál es el caso.
Seguridad en un minuto
- Una clave se muestra una sola vez, al crearla. Plur-e guarda solo un hash.
- Toda clave tiene caducidad (30, 90, 180 o 365 días) y se puede revocar en cualquier momento.
- Los scopes limitan el tipo de operación (leer, escribir, contabilizar, eliminar); los roles limitan qué entidades y áreas. La clave recibe la intersección de ambos.
- Los borrados de Business Central nunca están disponibles por la API.
- Cada petición se registra en el Usage log del Admin Center (90 días) sin la clave ni el cuerpo de la petición.
Conecta tu cliente de IA
Cómo conectar un cliente de escritorio o IDE, una plataforma de IA web y agentes a medida a un servidor MCP de Plur-e (MCP remoto sobre Streamable HTTP): inicia sesión con Microsoft o usa un token personal.
Autenticación
Cómo autenticarte en la API pública de Plur-e con una clave de API del tenant — la cabecera bearer, los cuatro mensajes 401, el plazo de revocación y los límites de tasa que responden 429.