[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Gérer les documents d'un dossier

L'outil marches_dossier_documents de Prescriptio rattache à un dossier de réponse les documents de votre bibliothèque : CV, références, mémoires, pièces administratives.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "library"
    },
    "name": "marches_dossier_documents"
  }
}
```

**HTTP (curl)**

```bash
curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"action":"library"},"name":"marches_dossier_documents"}}'
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "<texte>",
  "download_url": "<texte>",
  "fields": {},
  "files": [
    {}
  ],
  "ok": false,
  "page": 0,
  "pages_total": 0,
  "quota": {},
  "texte": "<texte>"
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `action` | `library` · `list` · `attach` · `detach` | oui | library (inventaire biblio), list (rattaches au dossier), attach, detach. |
| `draft_id` | texte | — | UUID du dossier AO (requis sauf action:library). |
| `knowledge_doc_id` | texte | — | UUID d'un document de la bibliotheque (attach/detach), via action:library. |
| `notes` | texte | — | Note de rattachement (optionnel). (max. caractères 1000) |

## Quand l'utiliser

action=library (inventaire, pour choisir quoi rattacher) ; list (documents déjà rattaches) ; attach (rattacher un knowledge_doc_id) ; detach (retirer). draft_id requis sauf pour library.

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Rattache à ce dossier nos références et notre attestation d'assurance depuis la bibliothèque.
```

Outil : `marches_dossier_documents` · Portée : `mcp:write`, écrit dans votre espace · Coût : 1 appel, aucune unité de dossier · Limite : agit dans votre espace seulement, jamais dans la donnée publique

## En bref

| | |
|---|---|
| Effets | lecture et écriture dans l'espace du compte |
| Portée OAuth | `mcp:write` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Données lues | l'espace du compte authentifié (ses alertes, ses dossiers, sa base) |
| Distribution | MCP historique |
| En REST | aucune opération : il s'appelle par le connecteur MCP |

## Réponse

Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les skills qui s'en servent

- [prescriptio-repondre-marches](https://prescriptio.fr/skills/prescriptio-repondre-marches) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `marches_dossier_documents`.

- [Appels d'offres](https://prescriptio.fr/docs/appels-offres) : Documentation, Les modules
- [Playbooks](https://prescriptio.fr/agents-ia/playbooks) : IA, Aller plus loin
- [Travailler une réponse à un marché](https://prescriptio.fr/skills/prescriptio-repondre-marches) : IA, Les skills du plugin

## Voir aussi

- [marches_rechercher](https://prescriptio.fr/docs/api/marches_rechercher) : Avis d'appels d'offres publics du bâti (BOAMP + DECP, ~744 000 avis)
- [marches_attributions](https://prescriptio.fr/docs/api/marches_attributions) : Qui a gagne quoi : attributions de marchés publics (DECP, ~308 000 contrats)
- [marches_dce](https://prescriptio.fr/docs/api/marches_dce) : Pièces d'un dossier de consultation (DCE)
- [marches_dce_lien_obtenir](https://prescriptio.fr/docs/api/marches_dce_lien_obtenir) : URL de téléchargement signée (valable 1 h) d'une pièce de DCE, ou de l'archive complete du dossier
- [marches_dossiers](https://prescriptio.fr/docs/api/marches_dossiers) : Pipeline des dossiers d'appels d'offres suivis (kanban du portefeuille)
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module