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 altalt --mcp-only1. 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.
https://mcp.altalt.io/mcpClaude / 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
claude mcp add --transport http alt https://mcp.altalt.io/mcpAprè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
Ajouter à CursorInstallation 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 filtreupdated_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.