Aller au contenu principal

Chatbotaurus en 5 minutes

Chatbotaurus est une plateforme MGaaS (MCP Gateway as a Service) 100% souveraine europeenne. Elle combine un agent IA conversationnel, un gateway MCP avec 40+ connecteurs, et une infrastructure EU complete.

Ce tutoriel rapide vous guide a travers :

  • Installation et configuration
  • Premier lancement
  • Premiere conversation avec l'agent IA
  • Decouverte du catalogue MCP

Pre-requis​

OutilVersionUsage
Node.js20.18.0Runtime (via nvm)
pnpm9.xGestionnaire de paquets
Git2.x+Versioning
Podman4.x+Conteneurs (Podman Desktop recommande)

Installation​

1. Cloner le repository​

git clone https://git.staging.chatbotaurus.eu/chatbotaurus-admin/chatbotaurus-mcp.git
cd chatbotaurus-mcp

2. Installer les dependances​

pnpm install

3. Configurer l'environnement​

cp .env.example packages/server/.env

Editez packages/server/.env avec vos parametres :

NODE_ENV=development
PORT=3000
JWT_SECRET=votre_secret_jwt_minimum_32_caracteres

# Infrastructure EU
REDIS_HOST=localhost
REDIS_PORT=6379
QDRANT_URL=http://localhost:6333
VAULT_ADDR=http://localhost:8200

# LLM EU (Ollama local)
OLLAMA_URL=http://localhost:11434

4. Initialiser la base de donnees​

cd packages/server
node reset-db.js

Lancement​

Backend (port 3000)​

cd packages/server
pnpm build
node start-direct.js

Frontend (port 3001)​

cd packages/new-ui
pnpm dev --port 3001

Ouvrez votre navigateur sur http://localhost:3001.

Premiere Conversation​

Une fois connecte a l'interface, vous pouvez interagir avec l'agent IA Chatbotaurus. L'agent utilise Ollama avec le modele qwen3:8b pour le raisonnement et tomng/nanbeige4.1:3b pour les reponses rapides.

Essayez par exemple :

Quels sont les connecteurs MCP disponibles pour la gestion d'entreprise ?

L'agent va interroger le catalogue MCP et vous presenter les connecteurs disponibles (Odoo, n8n, Matomo, etc.).

Catalogue MCP​

Le MCP Gateway fournit 40+ connecteurs API organises en catalogues :

  • Connecteurs Metier : Odoo (ERP), n8n (Workflows), Matomo (Analytics), Cal.com (Agenda)
  • Recherche EU : OpenAlex, CORDIS, Eurostat, Europeana
  • Securite : Vault (Secrets), Keycloak (SSO), Wazuh (SIEM)
  • Stockage EU : Nextcloud, OVHcloud, Scaleway

API Catalogue Business​

# Lister les serveurs MCP disponibles
curl http://localhost:3000/api/v1/mcp/catalog-business

# Statistiques du catalogue
curl http://localhost:3000/api/v1/mcp/catalog-business/stats

Transport MCP (Streamable HTTP)​

# Initialiser une session MCP
curl -X POST http://localhost:3000/api/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

Infrastructure Podman​

Pour lancer l'infrastructure EU complete avec Podman :

# Creer les reseaux
podman network create --subnet 172.28.0.0/16 chatbotaurus-network
podman network create --subnet 172.29.0.0/16 mgaas-network

# Deployer les services core
podman kube play --network chatbotaurus-network kubernetes/podman-local/00-core-pods.yaml

Prochaines Etapes​