Documentation développeur

MCP

Connectez Claude, Codex et d'autres clients MCP à vos notes Alt.

Alt propose un serveur MCP (Model Context Protocol) hébergé. Les clients compatibles OAuth se connectent dans le navigateur ; les clés d'API restent disponibles en solution de repli. Les deux méthodes appliquent les mêmes scopes en lecture seule et la même limite de workspace.

Par où commencer

Lancez l’assistant interactif dans le dossier du projet. Il vous guide pour connecter MCP, vérifier la clé API et les webhooks, puis transmettre l’implémentation à un agent de codage.

npx
npx altalt --mcp-only

1. Se connecter avec OAuth (recommandé)

Ajoutez l'endpoint sans en-tête. Votre client découvre le serveur d'autorisation Alt, s'enregistre et ouvre l'écran de consentement dans le navigateur.

  • Alt prend en charge Dynamic Client Registration et PKCE ; les clients compatibles configurent donc OAuth automatiquement.
  • Vérifiez dans le navigateur les scopes en lecture seule et le workspace demandés avant d'autoriser l'accès.
  • OAuth est actuellement réservé aux administrateurs Alt. Si une ancienne connexion OAuth Alt ne s'authentifie plus après cette mise à niveau, supprimez-la du client puis ajoutez-la à nouveau une fois.

2. Connecter votre client

Utilisez la configuration contenant uniquement l'URL pour OAuth. Aucun client ID ni secret OAuth n'est requis ; utilisez une clé d'API seulement si votre client ne peut pas terminer OAuth.

MCP URL
https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Ouvrez Customize → Connectors → Add custom connector, saisissez l'endpoint ci-dessus, laissez le client ID et le secret OAuth vides, puis sélectionnez Connect.

Claude Code

shell
claude mcp add --transport http alt https://mcp.altalt.io/mcp

Après avoir ajouté le serveur, ouvrez /mcp dans Claude Code, sélectionnez Alt et terminez l'authentification dans le navigateur.

Codex CLI

shell
codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt
config.toml
# ~/.codex/config.toml
[mcp_servers.alt]
url = "https://mcp.altalt.io/mcp"

L'ajout du serveur termine normalement l'authentification dans le navigateur. Si elle ne démarre pas, exécutez codex mcp login alt.

Cursor

Ajouter à Cursor

Installation en un clic avec l'URL uniquement. Dans les réglages MCP de Cursor, sélectionnez Connect ou Needs authentication, puis approuvez dans le navigateur.

Autres clients et solution par clé d'API

Commencez par la configuration OAuth contenant uniquement l'URL. Si le client ne prend pas en charge OAuth pour MCP, utilisez la configuration avec clé d'API Bearer.

OAuth
{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp"
    }
  }
}
Clé d'API
{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp",
      "headers": { "Authorization": "Bearer alt_live_..." }
    }
  }
}

Les clés d'API restent disponibles pour l'automatisation et les anciens clients. Créez-en une dans la console du compte, accordez uniquement les scopes nécessaires, ne la placez pas dans une configuration partagée et consultez Sécurité pour sa gestion.

3. Outils

Quatre outils en lecture seule, calqués sur l'API REST et appliquant les mêmes scopes.

  • list_notes Liste les notes visibles par la clé, avec pagination par curseur et filtre updated_after (notes:read).
  • get_note Récupère les métadonnées d'une note : titre, disponibilité de la transcription/du résumé, horodatages (notes:read).
  • get_note_transcript Récupère la transcription complète en segments horodatés avec étiquettes de locuteur (transcripts:read).
  • get_note_summary Récupère le résumé IA au format Markdown (summaries:read).

Les notes apparaissent une fois un enregistrement terminé ou un résumé généré — les notes mémo seules ne sont pas exportées. Tant que le contenu n'est pas prêt, les outils renvoient transcript_not_ready / summary_not_ready, pour que les agents réessaient plus tard.