Serveur MCP de ProjectForge

ProjectForge expose un serveur Model Context Protocol : Claude Code, Codex ou tout autre client MCP peut lire et écrire vos projets, tâches, documents, notes et carnet de bord. Le serveur ne génère aucun contenu — il stocke et organise ce que l'agent lui envoie.

Connexion

Endpoint : https://projectforge.tyu.re/mcp (transport HTTP streamable, requêtes POST en JSON-RPC)
Authentification : en-tête Authorization: Bearer <token>
Limite : 60 requêtes par minute

Le token se génère dans l'application, Settings → Accès MCP. Il n'est affiché qu'une seule fois. Vous choisissez sa portée :

read-only — l'agent ne voit que les outils de consultation ;
read-write — l'agent peut aussi créer, modifier et supprimer.

Dans tous les cas, l'agent n'accède qu'aux projets dont vous êtes membre, avec les droits de votre rôle.

Claude Code

claude mcp add --transport http projectforge https://projectforge.tyu.re/mcp --header "Authorization: Bearer <token>"

Codex et autres clients

Déclarez un serveur MCP HTTP pointant sur https://projectforge.tyu.re/mcp avec l'en-tête Authorization: Bearer <token>.

Vérifier la connexion

curl -X POST https://projectforge.tyu.re/mcp \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Outils

Lecture

list_workspaces — vos workspaces ; fournit le workspace_id nécessaire pour créer un projet.
list_projects — les projets dont vous êtes membre.
get_project — un projet complet : cahier des charges, diagrammes, documents et tâches.
list_tasks — les tâches d'un projet, ou vos tâches personnelles.
list_notes — vos notes, sur un projet ou partout.
list_journal_entries — le carnet de bord d'un projet.
search_documents — recherche plein texte dans les cahiers des charges, textes et présentations.

Écriture (token `read-write`)

create_project, update_project — créer un projet, en modifier une partie.
create_doc, update_doc — poser un cahier des charges, un diagramme Mermaid, un texte ou une présentation. Un diagramme modifié crée une nouvelle version.
create_task, update_task — ouvrir et faire avancer les tâches.
create_note, update_note, convert_note — noter, puis rattacher une note à la tâche qui en est née.
create_journal_entry — consigner une note ou une décision dans le carnet de bord.
delete_resource — supprimer une tâche, un document ou une note.

Ressources

Du contexte en lecture seule, que le client peut injecter directement :

projectforge://projects — l'index de vos projets.
projectforge://projects/{id} — le brief complet d'un projet : métadonnées, cahier des charges, documents, tâches ouvertes.
projectforge://projects/{id}/spec — le cahier des charges seul.

Prompt

triage_notes (project_id) — passe les notes non converties d'un projet en tâches, dans le bon ordre : create_task puis convert_note.

API de feedbacks

Vos propres applications peuvent envoyer des retours dans un projet, qui deviennent ensuite des tâches en un clic :

curl -X POST https://projectforge.tyu.re/api/feedback \
  -H "Authorization: Bearer <token-feedback-du-projet>" \
  -H "Accept: application/json" \
  -F type=bug -F title="Le bouton ne répond pas" -F description="Étapes pour reproduire…"

Champs : type (bug, feature ou other), title, description, et en option user_email, user_name, context (objet) et image (5 Mo max). Le token de feedback se trouve dans les paramètres du projet. Limite : 30 envois par heure.

Les erreurs sont toujours en JSON : un message, un code stable (missing_token, invalid_token, validation_failed, rate_limited…) et un hint qui dit comment s'en sortir. Le contrat complet est dans la spécification OpenAPI.