Vos documents, dans votre code et vos assistants IA

Deux façons d'accéder aux mêmes documents, avec les mêmes droits et les mêmes crédits :

Dans les deux cas, vous lisez votre espace : les documents déposés ou importés dans l'app. Les questions posées par l'API ou par MCP apparaissent dans votre chat, avec leurs sources.

1. 1

   Créez un compte et déposez au moins un document dans Documents.

2. 2

   Ouvrez Intégrations → API et MCP, nommez la clé selon son usage (« Claude Code », « Script de reporting »…), puis Créer une clé.

3. 3

   Copiez-la tout de suite : elle commence par ags_ et ne sera plus affichée. Gardez-la dans une variable d'environnement plutôt que dans votre code :

   Terminal

   export AGENTIC_SEARCH_API_KEY="ags_votre_cle"

4. 4

   Une clé se révoque à tout moment depuis la même page ; les clients qui l'utilisent perdent l'accès immédiatement. Comptez une clé par outil : vous en révoquez une sans couper les autres.

• Poser une question (ask) : 0,10 €, comme dans l'app : pris sur le crédit offert, puis prélevé en fin de mois avec le paiement à l'usage. Rien n'est facturé si la réponse n'a pas pu être produite.
• Rechercher, lister les documents, lire une page : gratuit. La recherche est limitée à 60 appels par heure et par clé.
• Questions de 2 000 caractères au plus ; 1 à 20 passages par recherche.
• 10 clés au plus par compte. Un membre invité a ses propres clés, sur l'espace du propriétaire.

Chaque requête porte la clé dans l'en-tête Authorization. Sans clé valide, l'API répond 401. La session de l'app (cookie) n'est jamais acceptée sur ces routes.

Authorization: Bearer ags_votre_cle

La clé donne accès à tout l'espace : appelez l'API depuis un serveur, jamais depuis du code exécuté dans le navigateur.

GET/api/v1/documents

Les documents de l'espace. Seuls ceux au statut ready sont interrogeables ; les autres sont en cours de lecture.

curl https://agentic-search.cc/api/v1/documents \
  -H "Authorization: Bearer $AGENTIC_SEARCH_API_KEY"

{
  "documents": [
    {
      "id": "5f0c2a8e-1b7d-4c3e-9a51-0e6d2f4b8c19",
      "name": "Rapport annuel 2023.pdf",
      "pages": 148,
      "status": "ready"
    },
    {
      "id": "a91d…",
      "name": "Contrat cadre.docx",
      "pages": 22,
      "status": "processing"
    }
  ]
}

POST/api/v1/search

Recherche hybride (mots exacts et sens) dans tous les documents, reclassée par pertinence. Rend les passages bruts, sans rédiger de réponse : pratique pour nourrir votre propre modèle. Gratuit.

curl https://agentic-search.cc/api/v1/search \
  -H "Authorization: Bearer $AGENTIC_SEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "chiffre d affaires 2023", "limit": 5}'

{
  "results": [
    {
      "document": "Rapport annuel 2023.pdf",
      "document_id": "5f0c2a8e-1b7d-4c3e-9a51-0e6d2f4b8c19",
      "page": 12,
      "text": "Le chiffre d'affaires consolidé atteint 1 284 M€, en hausse de 6,1 %…"
    }
  ]
}

POST/api/v1/ask

Le pipeline complet de l'app : recherche, raisonnement, réponse rédigée avec des citations [n] et leurs sources (document, page). Comptez 15 à 60 secondes : réglez le délai de votre client en conséquence. Coûte 0,10 €.

curl https://agentic-search.cc/api/v1/ask \
  -H "Authorization: Bearer $AGENTIC_SEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 180 \
  -d '{"question": "Quel est le chiffre d affaires 2023 ?"}'

{
  "answer": "Le chiffre d'affaires 2023 est de **1 284 M€** [1], en hausse de 6,1 % [1].",
  "sources": [
    {
      "n": 1,
      "document": "Rapport annuel 2023",
      "page": 12,
      "document_id": "5f0c2a8e-1b7d-4c3e-9a51-0e6d2f4b8c19",
      "excerpt": "Le chiffre d'affaires consolidé atteint 1 284 M€…"
    }
  ],
  "conversation_id": "0b6f…",
  "conversation_url": "https://…/dashboard/chat?c=0b6f…",
  "credits_used": 10,
  "balance": 410
}

GET/api/v1/documents/{document_id}/pages/{page}

Le texte complet d'une page, numérotée à partir de 1, pour vérifier une source. L'identifiant vient de la liste des documents ou du champ document_id d'une source.

curl https://agentic-search.cc/api/v1/documents/<id>/pages/12 \
  -H "Authorization: Bearer $AGENTIC_SEARCH_API_KEY"

{
  "document": "Rapport annuel 2023.pdf",
  "page": 12,
  "text": "…texte complet de la page…"
}

GET/api/v1/credits

Le crédit offert restant, en centimes (balance), et si le paiement à l'usage est actif. Sans paiement à l'usage, une question refusée faute de crédit rend 402.

curl https://agentic-search.cc/api/v1/credits \
  -H "Authorization: Bearer $AGENTIC_SEARCH_API_KEY"

{
  "balance": 410,
  "pay_as_you_go": false
}

Une erreur rend un statut HTTP et un message en français, à afficher tel quel à l'utilisateur :

{
  "error": "Solde insuffisant : cette action coûte 0,10 €, il reste 0,00 €. Activez le paiement à l'usage dans Facturation pour continuer."
}

Le serveur MCP d'Agentic Search est un serveur distant (HTTP). Pour le brancher, il faut deux choses :

https://<adresse du serveur MCP>/mcp

et une clé d'API (ags_…), envoyée dans l'en-tête Authorization. Chaque logiciel a sa façon de les renseigner : suivez la section du vôtre ci-dessous. Une fois branché, demandez simplement : « Dans mes documents Agentic Search, quel est le chiffre d'affaires 2023 ? Cite les pages. »

Les assistants préfèrent souvent search : ils reçoivent les passages et rédigent eux-mêmes. Demandez explicitement « pose la question à Agentic Search » pour obtenir la réponse vérifiée de ask.

Une commande, dans le terminal. L'option --scope user rend le serveur disponible dans tous vos projets.

claude mcp add --transport http --scope user agentic-search https://<adresse du serveur MCP>/mcp \
  --header "Authorization: Bearer $AGENTIC_SEARCH_API_KEY"

Vérifiez avec /mcp dans Claude Code : agentic-search doit apparaître comme connecté, avec ses quatre outils.

L'application de bureau lance les serveurs déclarés dans son fichier de configuration. Le petit programme mcp-remote (Node.js 18 ou plus) fait le pont vers notre serveur distant et y ajoute votre clé.

1. 1

   Ouvrez Réglages → Développeur → Modifier la configuration, ou directement ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows).

2. 2

   Ajoutez le serveur, avec votre clé :

   claude_desktop_config.json

   {
     "mcpServers": {
       "agentic-search": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://<adresse du serveur MCP>/mcp",
           "--header",
           "Authorization:${AUTH_HEADER}"
         ],
         "env": {
           "AUTH_HEADER": "Bearer ags_votre_cle"
         }
       }
     }
   }

3. 3

   Quittez et relancez Claude Desktop : les outils d'Agentic Search apparaissent dans le menu des outils de la conversation.

Les deux éditeurs acceptent un serveur distant avec un en-tête. Dans VS Code, la variable inputs demande la clé au premier lancement au lieu de l'écrire dans le fichier.

{
  "mcpServers": {
    "agentic-search": {
      "url": "https://<adresse du serveur MCP>/mcp",
      "headers": {
        "Authorization": "Bearer ags_votre_cle"
      }
    }
  }
}

Tout autre client MCP compatible « Streamable HTTP » se configure de la même façon : l'adresse du serveur et l'en-tête Authorization.

Ces assistants ajoutent un serveur distant comme connecteur personnalisé : vous collez l'adresse du serveur, cliquez sur Connecter, puis autorisez l'accès depuis votre compte Agentic Search (OAuth). Ils ne savent pas envoyer une clé d'API.

La connexion OAuth arrive prochainement ; cette section donnera alors la marche à suivre. D'ici là, utilisez Claude Desktop ou Claude Code, ou passez par l'API REST.

Les API de Claude et d'OpenAI se connectent elles-mêmes au serveur MCP : déclarez-le dans la requête, le modèle appelle les outils pendant sa réponse. Le serveur doit être joignable depuis Internet (pas d'adresse localhost). Avec LangGraph, l'adaptateur MCP transforme les outils en outils LangChain.

import os
import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    betas=["mcp-client-2025-11-20"],
    mcp_servers=[{
        "type": "url",
        "url": "https://<adresse du serveur MCP>/mcp",
        "name": "agentic-search",
        "authorization_token": os.environ["AGENTIC_SEARCH_API_KEY"],
    }],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "agentic-search"}],
    messages=[{"role": "user", "content": "Dans mes documents, quel est le chiffre d'affaires 2023 ? Cite les pages."}],
)
for block in response.content:
    if block.type == "text":
        print(block.text)

• Une clé lit tout l'espace et dépense ses crédits (ask) : ne la versionnez jamais dans un dépôt Git, ne la partagez pas, révoquez-la au moindre doute.
• L'espace interrogé est déterminé par la clé, jamais par ce qu'envoie l'assistant : un assistant ne peut pas lire l'espace d'un autre compte.
• Les passages renvoyés à l'assistant sont transmis au fournisseur de cet assistant (Anthropic, OpenAI, l'éditeur de votre logiciel), selon ses propres conditions.
• Un document peut contenir du texte qui ressemble à des consignes. Si votre agent peut aussi agir (envoyer un e-mail, modifier des fichiers), gardez une validation humaine sur ces actions.