docs: update all MCP documentation for 22 tools + API key auth
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 15s
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 15s
- Rewrite mcp-server/README.md: clean structure, auth section, 22 tools - Rewrite N8N-CONFIG.md: remove hardcoded IPs, add x-api-key auth flow - Rewrite N8N-WORKFLOWS.md: simplified, removed AI proxy tool references - Update README.md/README.fr.md: 37→22 tools, add auth mention - Update GUIDE.md/GUIDE.en.md: remove AI/API key tool tables, add auth - Update DEPLOY.md: SSE → Streamable HTTP in architecture diagram Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
51
GUIDE.md
51
GUIDE.md
@@ -52,7 +52,7 @@
|
||||
**Outils avances :**
|
||||
- **Canvas/Lab** - tableau blanc avec dessin (Excalidraw)
|
||||
- **Flux RSS** - integration de feeds RSS
|
||||
- **Serveur MCP** - 37 outils pour integrer avec Claude Desktop, N8N, ou tout client MCP
|
||||
- **Serveur MCP** - 22 outils pour integrer avec Claude Desktop, N8N, ou tout client MCP
|
||||
|
||||
**Administration :**
|
||||
- **Authentification** NextAuth.js v5 (credentials, inscription, reset mot de passe)
|
||||
@@ -108,10 +108,10 @@ Momento/
|
||||
│ ├── Dockerfile # Build multi-stage (node:22-bullseye-slim)
|
||||
│ ├── docker-compose.yml # Standalone (postgres + app)
|
||||
│ └── .env.example # Template dev local
|
||||
├── mcp-server/ # Serveur MCP (37 outils)
|
||||
├── mcp-server/ # Serveur MCP (22 outils)
|
||||
│ ├── index.js # Mode stdio (Claude Desktop)
|
||||
│ ├── index-sse.js # Mode HTTP Streamable (N8N, remote)
|
||||
│ ├── tools.js # Definitions des 37 outils MCP
|
||||
│ ├── tools.js # Definitions des 22 outils MCP
|
||||
│ ├── auth.js # Authentification API keys
|
||||
│ ├── Dockerfile # Conteneur MCP (node:20-alpine)
|
||||
│ └── .env.example # Template MCP
|
||||
@@ -434,9 +434,9 @@ Les agents sont aussi disponibles dans le **Chat IA** : si la recherche web est
|
||||
|
||||
Le serveur MCP (Model Context Protocol, v3.1) permet aux agents IA d'interagir avec vos notes via un protocole standardise.
|
||||
|
||||
### Outils disponibles (37 outils)
|
||||
### Outils disponibles (22 outils)
|
||||
|
||||
**Notes (12) :**
|
||||
**Notes (11) :**
|
||||
|
||||
| Outil | Description |
|
||||
|-------|-------------|
|
||||
@@ -445,7 +445,6 @@ Le serveur MCP (Model Context Protocol, v3.1) permet aux agents IA d'interagir a
|
||||
| `get_note` | Recuperer une note specifique |
|
||||
| `update_note` | Modifier une note existante |
|
||||
| `delete_note` | Supprimer une note |
|
||||
| `delete_all_notes` | Supprimer toutes les notes |
|
||||
| `search_notes` | Rechercher des notes par contenu |
|
||||
| `move_note` | Deplacer une note vers un notebook |
|
||||
| `toggle_pin` | Epingler/Depingler une note |
|
||||
@@ -473,36 +472,12 @@ Le serveur MCP (Model Context Protocol, v3.1) permet aux agents IA d'interagir a
|
||||
| `update_label` | Modifier un label |
|
||||
| `delete_label` | Supprimer un label |
|
||||
|
||||
**IA (11) :**
|
||||
|
||||
| Outil | Description |
|
||||
|-------|-------------|
|
||||
| `generate_title_suggestions` | Suggestions de titre pour une note |
|
||||
| `reformulate_text` | Reformuler un texte |
|
||||
| `generate_tags` | Generer des tags pour une note |
|
||||
| `suggest_notebook` | Suggerer un notebook pour une note |
|
||||
| `get_notebook_summary` | Resume d'un notebook |
|
||||
| `get_memory_echo` | Echo memoire - connexions entre notes |
|
||||
| `get_note_connections` | Connexions d'une note |
|
||||
| `dismiss_connection` | Ignorer une connexion |
|
||||
| `fuse_notes` | Fusionner des notes |
|
||||
| `batch_organize` | Organisation automatique par batch |
|
||||
| `suggest_auto_labels` | Suggerer des labels automatiques |
|
||||
|
||||
**Rappels (1) :**
|
||||
|
||||
| Outil | Description |
|
||||
|-------|-------------|
|
||||
| `get_due_reminders` | Recuperer les rappels dus |
|
||||
|
||||
**Gestion des cles API (3) :**
|
||||
|
||||
| Outil | Description |
|
||||
|-------|-------------|
|
||||
| `generate_api_key` | Generer une cle API |
|
||||
| `list_api_keys` | Lister les cles API |
|
||||
| `revoke_api_key` | Revoquer une cle API |
|
||||
|
||||
### Mode stdio (Claude Desktop, Cline)
|
||||
|
||||
Communication via stdin/stdout, ideal pour les clients locaux.
|
||||
@@ -521,15 +496,17 @@ Communication via stdin/stdout, ideal pour les clients locaux.
|
||||
|
||||
### Mode HTTP Streamable (N8N, remote)
|
||||
|
||||
Communication via HTTP Streamable (remplace l'ancien SSE), accessible sur le reseau.
|
||||
Communication via HTTP Streamable, accessible sur le reseau. L'authentification par cle API est activee par defaut dans Docker.
|
||||
|
||||
Les cles API sont generees depuis **Parametres > MCP** dans l'interface Memento.
|
||||
|
||||
```bash
|
||||
# .env.docker
|
||||
MCP_MODE="sse"
|
||||
MCP_PORT="3001"
|
||||
# docker-compose.yml (preconfigure)
|
||||
MCP_MODE=sse
|
||||
MCP_REQUIRE_AUTH=true
|
||||
```
|
||||
|
||||
Le serveur sera accessible sur `http://localhost:3001`.
|
||||
Le serveur sera accessible sur `http://localhost:3001/mcp`.
|
||||
|
||||
#### Endpoints HTTP
|
||||
|
||||
@@ -553,8 +530,7 @@ curl http://localhost:3001/
|
||||
# .env.docker
|
||||
MCP_LOG_LEVEL=info # debug, info, warn, error
|
||||
MCP_REQUEST_TIMEOUT=30000 # Timeout en ms
|
||||
MCP_REQUIRE_AUTH=false # Activer l'authentification
|
||||
MCP_API_KEY="votre-cle" # Cle API si auth active
|
||||
MCP_REQUIRE_AUTH=true # Authentification par cle API
|
||||
APP_BASE_URL="http://localhost:3000" # URL de l'app pour les liens
|
||||
```
|
||||
|
||||
@@ -567,6 +543,7 @@ APP_BASE_URL="http://localhost:3000" # URL de l'app pour les liens
|
||||
1. Ajouter un noeud **"MCP Client"** dans N8N
|
||||
2. Selectionner **"HTTP Streamable"** comme transport
|
||||
3. Configurer l'endpoint : `http://memento-mcp:3001/mcp` (Docker) ou `http://VOTRE_IP:3001/mcp`
|
||||
4. Ajouter une **Header Auth** : `x-api-key` = votre cle API (generee depuis Parametres > MCP)
|
||||
|
||||
### Workflows preconfigures
|
||||
|
||||
|
||||
Reference in New Issue
Block a user