# ProjectForge

> ProjectForge is a project management web app where each project gathers a specification document ("cahier des charges"), the documents derived from it (Mermaid flowcharts and database schemas, user stories, API endpoints, wireframes, slide decks), tasks, private notes and a shared project journal. It exposes an authenticated MCP server so AI agents such as Claude Code or Codex can read and write that data.

The interface and the public pages are in French. The server never generates content: everything comes from the user or from the MCP client they connect. Access is by invitation only (no public sign-up). Published by Kenny Lauret (La Réunion, France).

## When to use ProjectForge

Use ProjectForge when the user has a ProjectForge account and you need to:

- Read the full context of a project (specification, diagrams, documents, open tasks) before planning or writing code.
- Store a specification, a Mermaid diagram, a text document or a slide deck in the user's real project instead of a loose file.
- Turn a specification, meeting notes or a bug report into tasks and subtasks, then update their status as work progresses.
- Record a decision or a progress note in the project journal, so the team keeps a trace.
- Search across the user's specifications and documents with full-text search.
- Collect feedback from another application into a project through the feedback API.

Do not use it when:

- The user has no ProjectForge account or MCP token — access is invitation-only.
- You expect the server to write content for you: it only stores and organises what you send.
- You need public or anonymous data: everything is scoped to the projects the token owner is a member of.

## How to call it

- MCP endpoint: `POST https://projectforge.tyu.re/mcp` (Streamable HTTP, JSON-RPC), header `Authorization: Bearer <token>`.
- The user creates the token in Settings → "Accès MCP", with a `read-only` or `read-write` scope. Read-only tokens only see read tools.
- Claude Code: `claude mcp add --transport http projectforge https://projectforge.tyu.re/mcp --header "Authorization: Bearer <token>"`
- Start with `list_workspaces` and `list_projects`, then `get_project` or the resource `projectforge://projects/{id}`.
- Deletions all go through `delete_resource` (`task`, `document` or `note`).
- Rate limit: 60 requests per minute.

## Docs

- [MCP server documentation](https://projectforge.tyu.re/docs/mcp): connection, tools, resources, prompt and feedback API (French).
- [OpenAPI specification](https://projectforge.tyu.re/openapi.json): the feedback API (`submitFeedback`) and the MCP JSON-RPC endpoint (`callMcpServer`), with typed schemas. Every API error is JSON with a stable `code` and a `hint`.
- [Product overview](https://projectforge.tyu.re): every public page also answers `Accept: text/markdown` with a markdown version.

## About

- [About](https://projectforge.tyu.re/about)
- [Contact](https://projectforge.tyu.re/contact): tyu.lan@outlook.fr
- [Privacy policy](https://projectforge.tyu.re/privacy)
- [Sitemap](https://projectforge.tyu.re/sitemap.xml)