Aller au contenu
SPREVA

Commencer

Modes de connexion

Quatre façons de vous connecter, du simple collage d’une URL à la ligne de commande. Toutes les quatre donnent accès aux mêmes outils, avec les mêmes autorisations.

Lequel utiliser

  • Votre application peut ajouter un connecteur ou un serveur MCP distant : utilisez l’URL et connectez-vous. C’est le cas de la plupart des applications.
  • Personne n’est là pour cliquer sur Autoriser, comme pour un script, un serveur ou une tâche planifiée : utilisez une clé API.
  • Votre application ne démarre que des serveurs MCP sur votre machine : lancez le pont stdio de la CLI.
  • Votre agent travaille dans un terminal et utilise des skills : installez la CLI et l’Agent Skill.

1. URL du connecteur et connexion

Votre application communique avec SPREVA via le transport Streamable HTTP de MCP et vous connecte avec OAuth. Aucune clé à copier ni à protéger : vous choisissez l’espace de travail sur la page de SPREVA, et vous pouvez déconnecter l’application à tout moment.

URL
https://app.spreva.ai/api/mcp
  1. 1

    Collez l’URL là où votre application ajoute un connecteur ou un serveur MCP.

  2. 2

    Votre application ouvre SPREVA. Connectez-vous, choisissez l’espace de travail et cliquez sur Autoriser.

  3. 3

    Vous décidez dans SPREVA, sous Agents, de ce que les agents peuvent faire seuls ; c’est aussi là que vous déconnectez chaque application.

Recommandé. Fonctionne dans Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini CLI, Kimi CLI et la plupart des applications qui ajoutent des serveurs MCP par URL.

2. Clé API dans un en-tête

Pour une automatisation qui tourne sans intervention humaine, et pour les applications qui ne peuvent pas se connecter avec OAuth. Créez une clé dans SPREVA sous Développeurs, puis Clés API, et envoyez-la comme jeton Bearer :

En-tête
Authorization: Bearer spreva_sk_...

La plupart des applications la prennent dans leur configuration JSON. Une clé fonctionne avec les deux connecteurs.

JSON
{
  "mcpServers": {
    "spreva": {
      "type": "http",
      "url": "https://app.spreva.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer spreva_sk_..."
      }
    }
  }
}
Une clé appartient à un seul espace de travail, et quiconque la détient peut y agir. Ne la mettez pas dans des fichiers ou des dépôts partagés, et révoquez-la quand vous n’en avez plus besoin.

3. Le pont stdio de la CLI

Certaines applications ne démarrent des serveurs MCP que sur votre propre machine, via stdio. spreva mcp est un tel serveur : il tourne en local, lit votre clé API dans SPREVA_API_KEY et transmet chaque appel à SPREVA.

JSON
{
  "mcpServers": {
    "spreva": {
      "command": "npx",
      "args": [
        "-y",
        "@spreva/cli",
        "mcp"
      ],
      "env": {
        "SPREVA_API_KEY": "spreva_sk_..."
      }
    }
  }
}

Il nécessite Node.js 20 ou une version ultérieure. Les outils, les réponses et les autorisations sont les mêmes que via l’URL.

4. La CLI et l’Agent Skill

Les agents qui travaillent dans un terminal, comme OpenClaw, Hermes Agent, Claude Code et Codex, peuvent utiliser SPREVA en ligne de commande. L’Agent Skill leur indique quand y recourir et comment.

  1. 1

    Installez la CLI :

    Terminal
    npm i -g @spreva/cli
  2. 2

    Donnez-lui votre clé API :

    Terminal
    export SPREVA_API_KEY=spreva_sk_...
  3. 3

    Installez le skill pour votre agent. Les cibles sont claude, codex, openclaw, hermes et agents, pour tout autre agent qui prend en charge les skills :

    Terminal
    spreva skill install --target claude
  4. 4

    Vérifiez que tout est en place :

    Terminal
    spreva doctor

Plus de détails dans CLI et Agent Skill.