Documentation

Tout ce dont vous avez besoin pour integrer et deployer votre Kit Numerique souverain. API REST, Streamable HTTP, activation en un clic.

Demarrage rapide

01

Creer un compte

Inscrivez-vous et accedez a votre tableau de bord en quelques secondes.

# Inscription sur https://chatbotaurus.eu/auth/signup
02

Choisir votre Kit

Selectionnez votre secteur et activez les outils de votre Kit Numerique.

POST /api/v1/mcp
{ "jsonrpc": "2.0", "method": "initialize" }
03

Lancer votre activite

Activation en un clic sur infrastructure europeenne (Hetzner, OVH, Scaleway).

POST /api/v1/mcp/catalog-business/:id/deploy

Reference API

Transport MCP

Streamable HTTP (JSON-RPC 2.0) - Spec MCP 2025-03-26

POST/api/v1/mcp
GET/api/v1/mcp
DELETE/api/v1/mcp

Catalogue Public

Liste des serveurs MCP disponibles

GET/api/v1/mcp/catalog

Catalogue Business

Gestion avancee des serveurs MCP avec filtres et pagination

GET/api/v1/mcp/catalog-business
GET/api/v1/mcp/catalog-business/stats
GET/api/v1/mcp/catalog-business/:id

Deploiement One-Click

Lifecycle complet des conteneurs MCP via Podman

POST/api/v1/mcp/catalog-business/:id/deploy
POST/api/v1/mcp/catalog-business/:id/start
POST/api/v1/mcp/catalog-business/:id/stop
POST/api/v1/mcp/catalog-business/:id/restart
GET/api/v1/mcp/catalog-business/:id/status

Securite & Conformite

Scan Trivy, SBOM, secrets Vault, monitoring sante

GET/api/v1/mcp/catalog-business/:id/security
POST/api/v1/mcp/catalog-business/:id/secrets
GET/api/v1/mcp/catalog-business/deployed

Profils de Deploiement

Deploiement par profils preconfigures (starter, business, enterprise)

GET/api/v1/mcp/catalog-business/profiles
POST/api/v1/mcp/catalog-business/profiles/:name/deploy

Guides

Exemples de code

Initialiser une session MCP

// POST /api/v1/mcp
const response = await fetch(
  "https://api.chatbotaurus.eu/api/v1/mcp",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer <token>"
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 1,
      method: "initialize",
      params: {
        protocolVersion: "2025-03-26",
        clientInfo: {
          name: "mon-app",
          version: "1.0.0"
        }
      }
    })
  }
);
// Header Mcp-Session-Id retourne
const sessionId =
  response.headers.get("Mcp-Session-Id");

Lister les outils disponibles

// POST /api/v1/mcp
const tools = await fetch(
  "https://api.chatbotaurus.eu/api/v1/mcp",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer <token>",
      "Mcp-Session-Id": sessionId
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 2,
      method: "tools/list",
      params: {}
    })
  }
);
// Retourne 331+ outils Odoo,
// n8n, Matomo, etc.

Appeler un outil MCP

// POST /api/v1/mcp
const result = await fetch(
  "https://api.chatbotaurus.eu/api/v1/mcp",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer <token>",
      "Mcp-Session-Id": sessionId
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 3,
      method: "tools/call",
      params: {
        name: "odoo_crm_list_leads",
        arguments: {
          limit: 10,
          stage: "qualified"
        }
      }
    })
  }
);

Deployer un serveur MCP

// POST /api/v1/mcp/catalog-business
//       /:id/deploy
const deploy = await fetch(
  "https://api.chatbotaurus.eu" +
  "/api/v1/mcp/catalog-business" +
  "/odoo-eu/deploy",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer <token>"
    },
    body: JSON.stringify({
      profile: "business",
      region: "eu-west",
      secrets: {
        ADMIN_PASSWORD: "vault:secret/..."
      }
    })
  }
);
// Retourne containerId, status, port

Authentification

Headers requis

Authorization: Bearer <jwt_token>

Token JWT obtenu via Keycloak SSO

Mcp-Session-Id: <session_id>

Retourne par initialize, TTL 30 min

Content-Type: application/json

JSON-RPC 2.0 pour le transport MCP

Flux d'authentification

1

Obtenir un token via Keycloak (OAuth2 / OIDC)

2

Initialiser la session MCP avec le token

3

Utiliser le Mcp-Session-Id pour les appels suivants

4

Refresh automatique du JWT (rotation toutes les 15 min)

SDK et Integrations

SDKLangageStatut
TypeScript / Node.jsTypeScript
Disponible
PythonPython
Disponible
cURL / RESTShell
Disponible
n8n Connectorn8n
Disponible

Besoin d'aide pour l'integration ?

Notre equipe technique vous accompagne dans le deploiement de votre Kit Numerique.

Contacter l'equipe

Besoin d'une reponse immediate ?

Notre assistant IA souverain est disponible 24/7 pour repondre a vos questions techniques, vous guider dans votre projet ou resoudre vos problemes.

IA disponible maintenant
Reponse instantanee
IA souveraine EU
Disponible 24/7