MCP

Conectar con el conector de Claude

Alt está listado en el directorio de conectores de Claude, así que en la mayoría de los casos no necesitarás el endpoint de abajo. En Claude, abre Customize → Connectors, busca Alt y selecciona Connect.

• Aprueba el acceso en la pantalla de consentimiento de Alt y elige el único espacio que el conector podrá leer: tus notas personales o un canal.
• No hay nada que pegar ni ninguna clave de API que crear. Claude se registra por sí mismo mediante OAuth.
• Requiere una cuenta de Alt con un plan de pago. Las cuentas gratuitas llegan a la pantalla de consentimiento, pero reciben un error plan_required al aprobar.
• Solo lectura por diseño: lista notas y lee transcripciones y resúmenes, nunca escribe. Puedes revocarlo cuando quieras en la consola de la cuenta.

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.
• Conectar requiere una cuenta de Alt con un plan de pago. Las cuentas gratuitas llegan a la pantalla de consentimiento, pero reciben un error plan_required al aprobar.

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

Usa un conector personalizado solo para acceder a otro entorno de Alt: abre Customize → Connectors → Add custom connector, introduce el endpoint anterior y deja vacíos el client ID y el secret de OAuth.

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.