MCP

Se connecter avec le connecteur Claude

Alt figure dans l'annuaire des connecteurs Claude : dans la plupart des cas, vous n'aurez pas besoin de l'endpoint ci-dessous. Dans Claude, ouvrez Customize → Connectors, cherchez Alt et sélectionnez Connect.

• Approuvez l'accès sur l'écran de consentement d'Alt et choisissez le seul espace que le connecteur pourra lire : vos notes personnelles ou un canal.
• Rien à coller, aucune clé API à créer. Claude s'enregistre lui-même via OAuth.
• Nécessite un compte Alt avec une offre payante. Les comptes gratuits atteignent l'écran de consentement mais reçoivent une erreur plan_required lors de l'approbation.
• En lecture seule par conception : il liste les notes et lit les transcriptions et les résumés, sans jamais écrire. Révocable à tout moment dans la console du compte.

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.
• La connexion nécessite un compte Alt avec une offre payante. Les comptes gratuits atteignent l'écran de consentement mais reçoivent une erreur plan_required lors de l'approbation.

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.

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

N'utilisez un connecteur personnalisé que pour atteindre un autre environnement Alt : ouvrez Customize → Connectors → Add custom connector, saisissez l'endpoint ci-dessus et laissez vides le client ID et le secret OAuth.

Claude Code

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

codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt

# ~/.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

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.

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp"
    }
  }
}

{
  "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.