MCP

1. Conecta con OAuth (recomendado)

Añade el endpoint sin cabeceras. Tu cliente descubre el servidor de autorización de Alt, se registra y abre la pantalla de consentimiento en el navegador.

• Alt admite Dynamic Client Registration y PKCE, por lo que los clientes compatibles configuran OAuth automáticamente.
• Revisa en el navegador los scopes de solo lectura y el workspace solicitados antes de aprobar el acceso.
• OAuth está disponible actualmente solo para administradores de Alt. Si una conexión OAuth antigua de Alt deja de autenticarse tras esta actualización, elimínala del cliente y vuelve a añadirla una vez.

2. Conecta tu cliente

Usa la configuración que solo contiene la URL para OAuth. No necesitas un client ID ni un secret; utiliza una clave de API solo si tu cliente no puede completar OAuth.

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Abre Customize → Connectors → Add custom connector, introduce el endpoint anterior, deja vacíos el client ID y el secret de OAuth y selecciona Connect.

Claude Code

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

Después de añadir el servidor, abre /mcp en Claude Code, selecciona Alt y completa la autenticación en el navegador.

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"

Al añadir el servidor normalmente se completa la autenticación en el navegador. Si no se inicia, ejecuta codex mcp login alt.

Cursor

Instalación con un clic y solo la URL. En los ajustes MCP de Cursor, selecciona Connect o Needs authentication y aprueba el consentimiento en el navegador.

Otros clientes y alternativa con clave de API

Empieza con la configuración OAuth que solo contiene la URL. Si el cliente no admite OAuth para MCP, usa la configuración con clave de API Bearer.

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

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp",
      "headers": { "Authorization": "Bearer alt_live_..." }
    }
  }
}

Las claves de API siguen disponibles para automatizaciones y clientes antiguos. Crea una en la consola de la cuenta, concede solo los scopes necesarios, no la guardes en configuraciones compartidas y consulta Seguridad para gestionarla.

3. Herramientas

Cuatro herramientas de solo lectura que reflejan la API REST y aplican los mismos scopes.

• list_notes — Lista las notas visibles para la clave, con paginación por cursor y filtro updated_after (notes:read).
• get_note — Obtiene los metadatos de una nota: título, estado de transcripción/resumen, marcas de tiempo (notes:read).
• get_note_transcript — Obtiene la transcripción completa como segmentos con tiempos y etiquetas de hablante (transcripts:read).
• get_note_summary — Obtiene el resumen de IA como Markdown (summaries:read).

Las notas aparecen cuando una grabación termina o se genera un resumen — las notas de solo memo no se exportan. Antes de que el contenido esté listo, las herramientas devuelven transcript_not_ready / summary_not_ready, para que los agentes reintenten más tarde.