Aller au contenu

Serveur MCP

Serveur Model Context Protocol pour Claude et les autres agents MCP: trois outils sur vos sources.

Le lancer#

sextant mcp, du paquet sextant (installation).

VariableDescription
SEXTANT_APIURL de l'API (mode hébergé: votre bibliothèque, facturé sur votre compte)
SEXTANT_API_KEYvotre clé d'API
SEXTANT_ALLOW_LOCAL_FILEStrue: autorise les chemins de fichiers locaux (mode local)

Sans SEXTANT_API: mode local, moteur et bibliothèque dans le processus. Transport: stdio par défaut; sextant mcp --transport streamable-http --port 8765 sert du Streamable HTTP sur 127.0.0.1.

Connecter un client#

Claude Code#

bash
claude mcp add sextant \

  -e SEXTANT_API=https://api.example.com -e SEXTANT_API_KEY=sextant_... \

  -- uv run --directory <chemin-vers-sextant> sextant mcp

Claude Desktop, Cursor et les autres clients#

Configuration MCP du client (claude_desktop_config.json, .cursor/mcp.json...):

JSON
{

  "mcpServers": {

    "sextant": {

      "command": "uv",

      "args": ["run", "--directory", "<chemin-vers-sextant>", "sextant", "mcp"],

      "env": {

        "SEXTANT_API": "https://api.example.com",

        "SEXTANT_API_KEY": "sextant_..."

      }

    }

  }

}

Si sextant est installé dans l'environnement du client: "command": "sextant", "args": ["mcp"].

Outils#

Chaque résultat porte price_usd (tarifs de l'API). Le serveur demande à l'agent de signaler les instructions trouvées dans une source, jamais de les suivre.

ask#

Comme POST /v1/ask: toutes les questions, d'une phrase à un rapport.

ArgumentDescriptionDéfaut
questionrequis
sourcesidentifiants, URL, spécifications, identifiants ou noms de dossiers, chemins locaux (mode local); aucun: toute la bibliothèque
thread_idrelance; sans sources, reprend celles du thread
budgetfast, balanced, deepbalanced
max_output_tokensplafond de taille de la réponseaussi longue que la question le demande
answer_schemaun schéma JSON: la réponse est aussi donnée sous cette forme, dans dataaucun

Renvoie status, answer, evidence (8 au plus: id, source, where, quote, link), thread_id, turn, url (page du run), run_id, price_usd; avec answer_schema, data; avec insufficient_evidence, look_at (passages à lire avec read).

read#

Texte complet d'une preuve (ev_… de ask) ou d'un passage (id de look_at, comme src_…:p12), avec OCR ou transcription si besoin. Renvoie id, source, where, section, text (12 000 caractères au plus); pour une preuve, quote et link.

sources#

actionArgumentsRenvoie
list (défaut)sources (id, title, type, size, summary d'une ligne), total, dossiers (id, name avec chemin, nombre de sources)
addsource (URL, spécification, text:..., chemin local en mode local), folder (identifiant ou nom, créé si absent)id, title, type, size, plan