plnnrlydevelopers

Votre client IA, en votre nom.

Connectez Claude, ChatGPT, Cursor ou Gemini à votre organisation plnnrly, ou appelez l'API REST depuis votre propre code. Les deux agissent en votre nom, avec vos droits.

Vous construisez une intégration ? Commencez par l'API REST

https:///mcp/v1

Saisissez l'adresse où vous vous identifiez sur plnnrly, par exemple acme.plnnrly.com. Le panneau IA de plnnrly (l'icône étincelles dans la barre du haut) affiche l'URL exacte.

Où trouver mon URL ?

Saisissez l'adresse où vous vous identifiez sur plnnrly, par exemple acme.plnnrly.com. Le panneau IA de plnnrly (l'icône étincelles dans la barre du haut) affiche l'URL exacte.

Ajoutez-la ensuite à votre client

Un connecteur personnalisé sur votre compte Claude. Il fonctionne ensuite aussi dans Claude Desktop et les applications mobiles.

  1. Dans Claude, ouvrez Customize › Connectors et choisissez Add custom connector.
  2. Saisissez plnnrly comme nom et collez l'URL du serveur.
  3. Cliquez sur Add, identifiez-vous sur plnnrly et cliquez sur Autoriser.
Guide complet pour claude.ai

Le même connecteur que sur claude.ai. Si vous l'y avez ajouté, il est déjà là.

  1. Dans Claude Desktop, ouvrez Customize › Connectors et choisissez Add custom connector.
  2. Saisissez plnnrly comme nom et collez l'URL du serveur.
  3. Cliquez sur Add. Une fenêtre plnnrly s'ouvre dans votre navigateur : identifiez-vous et cliquez sur Autoriser.
Guide complet pour Claude Desktop

Lancez cette commande dans votre terminal, puis identifiez-vous avec claude mcp login plnnrly.

Terminal
claude mcp add --transport http plnnrly https://<votre-url>/mcp/v1
Guide complet pour Claude Code

ChatGPT sur le web ajoute plnnrly comme serveur MCP personnalisé.

  1. Ouvrez chatgpt.com/plugins et choisissez +, puis Add custom MCP server.
  2. Collez l'URL du serveur sous Connection et choisissez OAuth.
  3. Créez et installez le plugin. Identifiez-vous ensuite sur plnnrly et cliquez sur Autoriser.
Guide complet pour ChatGPT

Ajoutez cette entrée à ~/.cursor/mcp.json. Cursor vous demande de vous identifier sur plnnrly quand il se connecte.

~/.cursor/mcp.json
{
  "mcpServers": {
    "plnnrly": {
      "url": "https://<votre-url>/mcp/v1"
    }
  }
}
Guide complet pour Cursor

Lancez cette commande dans votre terminal, démarrez gemini et identifiez-vous avec /mcp auth plnnrly.

Terminal
gemini mcp add --transport http --scope user plnnrly https://<votre-url>/mcp/v1
Guide complet pour Gemini
Autres clients

Ce qui se passe quand vous demandez

Vous demandez

Lesquels de mes éléments de travail sont encore ouverts ?

Outil
api_read
Requête
GET /work-itemsfilter[assignee_id]=mefilter[resolved]=false
Vérifié
Réponse
200 OKVos éléments de travail ouverts, page par page

Les mêmes contrôles que l'API REST. Un client ne fait jamais plus que ce que vous pouvez faire.

Ce que le serveur peut faire

Il n'y a pas d'outil par fonction : un client cherche l'opération dont il a besoin, lit ce qu'elle accepte, puis l'appelle en votre nom. Tout est accessible, sauf l'envoi de fichiers.

  • search_api

    Trouve l'opération de l'API qui correspond à une tâche et montre ce qu'elle accepte.

    Lit la documentation, pas vos données

  • api_read

    Lit tout ce que l'API REST peut lire.

    Vos droits de lecture

  • api_write

    Crée et modifie des données. Ne supprime que si votre organisation l'autorise et que vous confirmez.

    Vos droits d'écriture ; demande avant de supprimer

  • get-current-user-tool

    Renvoie votre propre profil.

    Votre propre profil

Comment fonctionnent les outils

Avant de vous connecter

MCP est désactivé pour les nouvelles organisations. Un administrateur l'active, et il ne fonctionne que tant que l'API REST est activée.

ParamètrePar défautCe qu'il fait
Activer l'API RESTActivéPermet d'appeler l'API REST avec ses propres tokens API, et aux applications d'identifier les utilisateurs via OAuth.
Activer MCPDésactivéPermet de connecter un client IA, comme Claude ou ChatGPT, en s'identifiant. Le client passe par l'API REST, au nom de la personne qui l'a connecté.Nécessite Activer l'API REST.
Autoriser les actions destructivesDésactivéPermet à un client IA connecté de supprimer ce que l'API REST peut supprimer, dans la limite des droits de la personne et seulement après sa confirmation.Nécessite Activer MCP.

Paramètres › Administration › MCP & API

Pour les administrateurs

Plutôt du code ?

L'API REST lit et modifie projets, éléments de travail, heures, documents Drive, clients, factures, congés et planification. Chaque opération indique les autorisations du token et le droit dont elle a besoin.

  1. Créez un token : menu utilisateur › Accès API › Créer un token.
  2. Votre URL de base est https://<votre-url>/api/v2/.
  3. Premier appel : GET /api/v2/ montre ce que votre organisation expose.

Votre premier appel à l'API (en anglais)

La référence décrit 228 opérations, générées à partir du code de plnnrly à chaque version.

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

Guides

Pour commencer

Travailler avec les données

Quand ça ne marche pas

  • Dépannage

    Quand un client ne parvient pas à se connecter ou à s'identifier, ou voit une requête refusée.

  • Errors and retries (en anglais)

    Chaque échec est un document de problème. Décidez selon son type, pas seulement selon le code de statut.

  • Rate limits (en anglais)

    Ce que coûte chaque requête, et les en-têtes qui indiquent ce qu'il reste.