AltOrbit para agentes de IA (MCP)

Resumen

AltOrbit ofrece un servidor remoto que habla el Model Context Protocol (MCP), el estándar abierto con el que las apps de IA llaman a herramientas externas. Añádelo una vez a tu cliente de IA y el asistente podrá trabajar con tu workspace de AltOrbit: buscar y leer tickets, crearlos y cambiarlos, comentar, moverlos por el tablero, registrar tiempo y resumir cómo va un proyecto. Los clientes de un estudio pueden seguir y gestionar sus propias solicitudes de la misma forma.

https://api.altorbit.app/mcp

El servidor usa Streamable HTTP. Los clientes inician sesión con OAuth: apruebas la conexión en una página de AltOrbit y nunca pegas una contraseña ni una clave en la app de IA. Los clientes que no pueden iniciar sesión pueden usar un token de acceso personal.

Qué puedes hacer con él

Las herramientas que recibes dependen de tu rol en el workspace, no de tu puesto. Algunas cosas que se le piden:

Conecta tu cliente de IA

Todos los clientes de abajo inician sesión a través de la página de consentimiento de AltOrbit: se abre en tu navegador, muestra qué app lo pide y qué podrá hacer, y te pide confirmar que eres tú antes de aprobar. Allí eliges el workspace con el que trabajará la app. También tienes esta guía, con botones listos, en la app web en Ajustes › Agentes de IA.

Claude

En claude.ai o en la app de escritorio de Claude, abre Settings › Connectors y elige Add custom connector. Llámalo AltOrbit, pega la URL del servidor y pulsa Add; luego Connect y aprueba la solicitud en AltOrbit. Activa el conector en un chat desde el menú de herramientas.

Cuando AltOrbit aparezca en el directorio de conectores de Claude, podrás añadirlo desde allí sin pegar la URL.

Claude Code

Ejecuta esto en una terminal:

claude mcp add --transport http altorbit https://api.altorbit.app/mcp

Luego escribe /mcp en Claude Code, elige altorbit e inicia sesión. Añade --scope user para usarlo en todos tus proyectos, o --scope project para compartirlo con tu repositorio.

Cursor

Usa el enlace de instalación de abajo y luego pulsa Connect junto a altorbit en Cursor Settings › MCP y aprueba la solicitud.

Añadir AltOrbit a Cursor →

O añádelo a mano:

{
  "mcpServers": {
    "altorbit": {
      "url": "https://api.altorbit.app/mcp?toolsets=compact"
    }
  }
}

El enlace y la configuración usan el preset compact, porque Cursor cuenta juntas las herramientas de todos tus servidores MCP. Quita ?toolsets=compact para tener todas las herramientas, o añade conjuntos detrás, como compact,reports.

VS Code

Usa el enlace de instalación de abajo. VS Code te pide iniciar sesión la primera vez que GitHub Copilot usa una herramienta de AltOrbit en modo agente.

Añadir AltOrbit a VS Code →

O añádelo a tu workspace a mano:

{
  "servers": {
    "altorbit": {
      "type": "http",
      "url": "https://api.altorbit.app/mcp"
    }
  }
}

Codex

Añade el servidor a ~/.codex/config.toml e inicia sesión desde una terminal:

[mcp_servers.altorbit]
url = "https://api.altorbit.app/mcp"

codex mcp login altorbit

ChatGPT

En ChatGPT, abre Settings › Apps & Connectors › Advanced settings y activa Developer mode (si tu plan lo ofrece). Luego elige Create, llámalo AltOrbit, pega la URL del servidor, elige OAuth y aprueba la solicitud en AltOrbit.

Windsurf

Abre Windsurf Settings › Cascade › MCP servers, elige editar la configuración en bruto y añade el servidor. Si Windsurf no ofrece iniciar sesión, usa un token de acceso personal como se muestra abajo. La configuración usa el preset compact: como Cursor, Windsurf cuenta juntas las herramientas de todos tus servidores.

{
  "mcpServers": {
    "altorbit": {
      "serverUrl": "https://api.altorbit.app/mcp?toolsets=compact"
    }
  }
}

Tokens de acceso personal

Para un cliente o script que no puede iniciar sesión con OAuth, envía un token en la cabecera Authorization. Un token actúa como tú, en un solo workspace, con solo los permisos que elijas.

• En la app web de AltOrbit, abre Ajustes › Agentes de IA › Tokens de acceso personal y elige Crear token.
• Ponle un nombre, elige el workspace y los permisos y confirma que eres tú. Puedes darle una vida más corta.
• Copia el token — empieza por ao_pat_ y se muestra una sola vez — y envíalo como bearer token.

Authorization: Bearer ao_pat_…

Por ejemplo:

claude mcp add --transport http altorbit https://api.altorbit.app/mcp --header "Authorization: Bearer ao_pat_…"

{
  "mcpServers": {
    "altorbit": {
      "serverUrl": "https://api.altorbit.app/mcp?toolsets=compact",
      "headers": {
        "Authorization": "Bearer ao_pat_…"
      }
    }
  }
}

Conjuntos de herramientas

Las herramientas se agrupan en conjuntos. Por defecto, una conexión recibe todas las herramientas que permiten tu rol y tus permisos. Para ofrecer menos herramientas a la IA, indica los conjuntos que quieres o un preset; core siempre se incluye.

Añade ?toolsets= a la URL del servidor con una lista separada por comas, por ejemplo ?toolsets=tickets,time. Un cliente que no puede cambiar la URL puede enviar la cabecera X-MCP-Toolsets; si están las dos, gana la URL. Los nombres desconocidos se ignoran.

Cursor y Windsurf: el preset compact

Cursor y Windsurf cuentan juntas las herramientas de todos tus servidores MCP y dejan de ofrecer al modelo las que superan su límite. Solo AltOrbit puede ofrecer unas cuantas decenas de herramientas a un propietario, así que junto a otros servidores algunas pueden desaparecer sin aviso. El preset compact conserva el trabajo diario — core, tickets, time y client — y deja fuera versiones, configuración del tablero, decisiones sobre solicitudes, archivos, informes y notificaciones. La configuración de Cursor y Windsurf de arriba ya lo usa. Cuántas herramientas recibe cada rol:

Los presets y los conjuntos se combinan: ?toolsets=compact,reports añade los informes, ?toolsets=compact,files añade los archivos.

La lista de conjuntos no cambia lo que tienes permitido, y el inicio de sesión es el mismo con ella o sin ella.

Herramientas

Todas las herramientas, por conjunto. Quién es el rol mínimo que ve la herramienta; Scope es el permiso que necesita la conexión; Tipo indica si la herramienta solo lee, cambia algo o puede borrar o sobrescribir datos, y los clientes de IA lo usan para decidir cuándo preguntarte antes. Las herramientas nombran las cosas como lo hace la gente: tickets por clave (WEB-123), proyectos por clave o nombre, personas por nombre o «yo», columnas, etiquetas e hitos por nombre. Las listas van paginadas y los textos largos se acortan y se marcan.

Solo en la app de AltOrbit

Algunas cosas se quedan en la app a propósito: vaciar la papelera, editar una descripción a la vez en directo, ver quién está conectado, convertir mensajes del chat en tickets, gestionar personas, invitaciones e insignias, registrar ingresos y los archivos de más de 700 KB.

Prompts

El servidor también ofrece prompts listos para usar. Cada cliente los muestra a su manera — en Claude Code, por ejemplo, como comandos de barra.

• my_day — planifica tu día a partir de tus tickets asignados, el temporizador y las notificaciones sin leer (Miembros del equipo)
• status_report — redacta una actualización de estado de un proyecto a partir de su tablero, ritmo y estimaciones (Miembros del equipo)
• triage_intake — repasa los tickets nuevos y las solicitudes de clientes que nadie ha ordenado aún (Miembros del equipo)
• verify_ticket — revisa un ticket en revisión frente a lo que se pidió (Miembros del equipo)
• my_requests_status — resume tus solicitudes al estudio y lo que espera tu respuesta (Clientes)

Permisos

Una app de IA actúa como tú. Ve y cambia solo lo que podrías ver y cambiar tú en AltOrbit, en el único workspace al que la conectaste, y nunca más que los scopes que concediste. AltOrbit comprueba todas las reglas de la app — quién ve los importes, quién puede mandar un ticket a la papelera, qué puede editar un cliente — en cada llamada, pida lo que pida la IA.

Scopes

Roles

• Los miembros del equipo reciben herramientas de tickets, tiempo, informes y notificaciones en los proyectos a los que pertenecen. Los campos de importes aparecen solo donde su rol los ve en la app.
• Los propietarios, los admins de la empresa y los admins de equipo reciben además el informe de carga del equipo, columnas y etiquetas del tablero, la papelera y la decisión sobre solicitudes de clientes y sus presupuestos.
• Los clientes de un estudio reciben solo herramientas de cliente, ven solo lo que el estudio comparte con ellos y solo pueden tener los scopes profile, projects.read, tickets.read y tickets.write.

Si una herramienta necesita un scope que la conexión no tiene, el servidor responde 403 insufficient_scope y lo nombra, para que tu cliente te pida aprobar más. Una herramienta que tu rol no puede usar simplemente no se ofrece.

Controles del workspace

Los propietarios y los administradores de la empresa deciden si las apps de IA pueden trabajar con el workspace. Pueden:

• Desactivar las conexiones de IA para todo el workspace; están activadas por defecto. Desactivarlas pone en pausa las apps y los tokens ya conectados en lugar de revocarlos: cada llamada a una herramienta se rechaza con un error que indica que la organización ha desactivado el acceso de agentes de IA, y no se puede conectar ninguna app ni crear ningún token nuevo. Al volver a activarlas, todas las apps y tokens que no se hayan revocado ni hayan caducado mientras tanto vuelven a funcionar sin reconectar.
• Ver y revocar cualquier app de IA o token conectado al workspace, lo haya conectado quien lo haya conectado. Su titular recibe un aviso cuando se revoca.
• Enterarse de las nuevas conexiones — los propietarios y los administradores de la empresa reciben un aviso cuando un miembro conecta una app de IA o crea un token de acceso personal.

Seguridad

Cómo mantiene AltOrbit bajo control una app de IA conectada:

• Consentimiento con reautenticación — OAuth 2.1 con PKCE. La página de consentimiento en app.altorbit.app muestra qué app lo pide, quién la respalda y adónde va el acceso. Aprobar una app o crear un token te pide confirmar que eres tú con cualquiera de estas opciones: una passkey (Face ID o huella), una cuenta vinculada como Google, Apple o GitHub, un código de verificación en dos pasos, tu contraseña o un código de un solo uso enviado a tu email. Tras iniciar sesión o confirmar, no se te vuelve a pedir durante 2 horas; cada aprobación o token nuevo reinicia ese plazo.
• Acceso de corta duración — un token de acceso dura una hora. Los refresh tokens cambian en cada uso y caducan tras 30 días sin uso, y como mucho a los 365 días.
• Los tokens de acceso personal se muestran una sola vez, caducan tras 90 días sin uso y como mucho a los 365 días (o antes si lo eliges) y llevan el prefijo fijo ao_pat_ para que los escáneres de secretos detecten uno filtrado.
• Sin secretos guardados — los tokens se guardan solo como hashes con clave; te mostramos los cuatro últimos caracteres para distinguirlos.
• Comprobado en cada llamada — tu pertenencia, tu rol y tu acceso de cliente se leen de nuevo cada vez, así que perder el acceso en AltOrbit corta la app de IA al instante.
• Los eventos de la cuenta alcanzan a los agentes — restablecer tu contraseña, cambiar el inicio de sesión en dos pasos o cerrar todas las demás sesiones también desconecta todas las apps de IA y tokens. Cuando un propietario o administrador de la empresa desactiva las conexiones de IA del workspace, en cambio, quedan en pausa — consulta Controles del workspace.
• Registro de auditoría — las acciones que AltOrbit audita cuando las haces tú en la app, como cambios en tickets, tablero y solicitudes, también se registran en el registro de auditoría del workspace cuando las hace una app de IA, junto con los intentos rechazados. Cada registro indica la herramienta, la conexión y el nombre que la app se dio a sí misma.
• Marcado en el historial del ticket — cada versión guardada de un ticket indica de dónde vino el cambio: la app, el portal de clientes o MCP.
• El contenido son datos — AltOrbit indica al modelo que trate títulos, descripciones y comentarios como datos y nunca como instrucciones, y marca qué herramientas cambian cosas para que tu cliente pueda preguntarte antes. Tus permisos se aplican en el servidor en cualquier caso.
• Límites de uso — una app de IA tiene los mismos límites por usuario que tú en la app.

Revocar el acceso

• Apps conectadas — en la app web, abre Ajustes › Agentes de IA y elige Desconectar junto a la app. Sus tokens dejan de funcionar al instante; para volver a usarla, conéctala y apruébala de nuevo.
• Tokens de acceso personal — en el mismo lugar, elige Revocar. Cualquier herramienta que use el token deja de funcionar al instante.
• Los propietarios y los administradores de la empresa pueden revocar cualquier app o token conectado al workspace, o ponerlos todos en pausa desactivando las conexiones de IA — consulta Controles del workspace.
• Eliminar tu cuenta de AltOrbit elimina todas tus conexiones y tokens. También puedes quitar AltOrbit de tu cliente de IA, pero solo revocarlo en AltOrbit termina su acceso.

Solución de problemas

Soporte y privacidad

Preguntas o problemas con el conector: escribe a support@altorbit.app o usa el formulario de la página de soporte. Cómo tratamos los datos cuando conectas una app de IA se describe en nuestra Política de privacidad; los informes de seguridad van a security@altorbit.app.