AltOrbit для AI-агентов (MCP)

Обзор

AltOrbit держит удалённый сервер на Model Context Protocol (MCP) — открытом стандарте, по которому AI-приложения вызывают внешние инструменты. Добавь его в свой AI-клиент один раз, и ассистент сможет работать с твоим воркспейсом AltOrbit: находить и читать тикеты, создавать и менять их, комментировать, двигать по доске, трекать время и рассказывать, как идёт проект. Клиенты студии так же следят за своими запросами и управляют ими.

https://api.altorbit.app/mcp

Сервер работает по Streamable HTTP. Клиенты входят через OAuth: ты подтверждаешь подключение на странице AltOrbit, и ни пароль, ни ключ в AI-приложение вставлять не нужно. Клиент, который не умеет входить, может использовать персональный токен доступа.

Что можно с ним делать

Набор инструментов зависит от твоей роли в воркспейсе, а не от должности. Вот о чём чаще всего просят:

Подключение AI-клиента

Любой клиент ниже входит через страницу согласия AltOrbit: она открывается в браузере, показывает, какое приложение просит доступ и что ему будет разрешено, и перед подтверждением просит ещё раз подтвердить, что это ты. Там же выбираешь воркспейс, с которым приложение будет работать. Эта же инструкция с готовыми кнопками есть в веб-приложении в разделе Настройки › AI-агенты.

Claude

На claude.ai или в десктопном приложении Claude открой Settings › Connectors и выбери Add custom connector. Назови его AltOrbit, вставь URL сервера и нажми Add, затем Connect и подтверди запрос в AltOrbit. Включи коннектор в чате через меню инструментов.

Когда AltOrbit появится в каталоге коннекторов Claude, его можно будет добавить оттуда, без ввода URL.

Claude Code

Выполни в терминале:

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

Затем набери /mcp в Claude Code, выбери altorbit и войди. Добавь --scope user, чтобы сервер был во всех проектах, или --scope project, чтобы поделиться им через репозиторий.

Cursor

Нажми ссылку установки ниже, затем Connect рядом с altorbit в Cursor Settings › MCP и подтверди запрос.

Добавить AltOrbit в Cursor →

Или добавь вручную:

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

Ссылка и конфиг используют пресет compact, потому что Cursor считает инструменты всех твоих MCP-серверов вместе. Убери ?toolsets=compact, чтобы получить все инструменты, или допиши после него нужные наборы, например compact,reports.

VS Code

Нажми ссылку установки ниже. VS Code попросит войти, когда GitHub Copilot в режиме агента впервые вызовет инструмент AltOrbit.

Добавить AltOrbit в VS Code →

Или добавь в воркспейс вручную:

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

Codex

Добавь сервер в ~/.codex/config.toml и войди из терминала:

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

codex mcp login altorbit

ChatGPT

В ChatGPT открой Settings › Apps & Connectors › Advanced settings и включи Developer mode (если твой тариф это позволяет). Затем выбери Create, назови его AltOrbit, вставь URL сервера, выбери OAuth и подтверди запрос в AltOrbit.

Windsurf

Открой Windsurf Settings › Cascade › MCP servers, выбери редактирование исходного конфига и добавь сервер. Если Windsurf не предлагает войти, используй персональный токен доступа, как показано ниже. Конфиг использует пресет compact: Windsurf, как и Cursor, считает инструменты всех серверов вместе.

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

Персональные токены доступа

Для клиента или скрипта, который не умеет входить через OAuth, передавай токен в заголовке Authorization. Токен действует от твоего имени, в одном воркспейсе и только с выбранными правами.

• В веб-приложении AltOrbit открой Настройки › AI-агенты › Персональные токены доступа и нажми Создать токен.
• Дай ему имя, выбери воркспейс и права и подтверди, что это ты. Срок жизни можно сделать короче.
• Скопируй токен — он начинается с ao_pat_ и показывается один раз — и передавай его как bearer-токен.

Authorization: Bearer ao_pat_…

Например:

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_…"
      }
    }
  }
}

Наборы инструментов

Инструменты сгруппированы в наборы. По умолчанию подключение получает все инструменты, которые позволяют твоя роль и права. Чтобы дать AI меньше инструментов, перечисли нужные наборы или пресет; core включён всегда.

Добавь к URL сервера ?toolsets= со списком через запятую, например ?toolsets=tickets,time. Клиент, который не может менять URL, может передать заголовок X-MCP-Toolsets; если заданы оба, побеждает URL. Неизвестные имена игнорируются.

Cursor и Windsurf: пресет compact

Cursor и Windsurf считают инструменты всех твоих MCP-серверов вместе и не передают модели те, что выходят за их лимит. Один только AltOrbit даёт владельцу несколько десятков инструментов, так что рядом с другими серверами часть из них может молча выпасть. Пресет compact оставляет повседневную работу — core, tickets, time и client — и убирает версии, настройку доски, решения по запросам, файлы, отчёты и уведомления. Настройка Cursor и Windsurf выше уже его использует. Сколько инструментов получает каждая роль:

Пресеты и наборы комбинируются: ?toolsets=compact,reports добавляет отчёты, ?toolsets=compact,files — файлы.

Список наборов не меняет того, что тебе разрешено, и вход с ним и без него одинаковый.

Инструменты

Все инструменты по наборам. Кто — минимальная роль, которой инструмент виден; Скоуп — право, которое нужно подключению; Тип говорит, только ли инструмент читает, что-то меняет или может удалить либо перезаписать данные, — по нему AI-клиенты решают, когда спросить тебя заранее. Инструменты называют вещи так, как это делают люди: тикеты по ключу (WEB-123), проекты по ключу или названию, людей по имени или «я», колонки, метки и вехи по названию. Списки разбиты на страницы, длинные тексты сокращаются с пометкой.

Только в приложении AltOrbit

Часть вещей намеренно остаётся в приложении: очистка корзины, совместное редактирование описания в реальном времени, кто сейчас онлайн, тикеты из сообщений чата, управление людьми, приглашения и бейджи, проводка выручки и файлы больше 700 КБ.

Промпты

Ещё сервер предлагает готовые промпты. Клиенты показывают их по-разному — в Claude Code, например, как слеш-команды.

• my_day — план дня по твоим тикетам, таймеру и непрочитанным уведомлениям (Участники команды)
• status_report — черновик статус-апдейта по проекту из доски, скорости и оценок (Участники команды)
• triage_intake — разбор новых тикетов и клиентских запросов, до которых никто не добрался (Участники команды)
• verify_ticket — проверка тикета в ревью против того, что просили (Участники команды)
• my_requests_status — сводка твоих запросов к студии и того, что ждёт твоего ответа (Клиенты)

Права

AI-приложение действует от твоего имени. Оно видит и меняет только то, что мог бы ты сам в AltOrbit, в одном воркспейсе, к которому ты его подключил, и никогда не больше выданных скоупов. Все правила приложения — кто видит деньги, кто может отправить тикет в корзину, что может править клиент — AltOrbit проверяет на каждом вызове, что бы ни просил AI.

Скоупы

Роли

• Участники команды получают инструменты тикетов, времени, отчётов и уведомлений в своих проектах. Денежные поля видны только там, где их роль видит их в приложении.
• Владельцы, админы компании и админы команд дополнительно получают отчёт о загрузке команды, колонки и метки доски, корзину и решения по клиентским запросам и их бюджетам.
• Клиенты студии получают только клиентские инструменты, видят только то, чем делится студия, и могут иметь только скоупы profile, projects.read, tickets.read и tickets.write.

Если инструменту нужен скоуп, которого у подключения нет, сервер отвечает 403 insufficient_scope и называет его, чтобы клиент мог попросить тебя одобрить больше. Инструмент, недоступный твоей роли, просто не предлагается.

Управление на уровне воркспейса

Владельцы и администраторы компании решают, могут ли AI-приложения вообще работать с воркспейсом. Они могут:

• Выключить AI-подключения для всего воркспейса; по умолчанию они включены. Выключение ставит подключённые приложения и токены на паузу, а не отзывает их: каждый вызов инструмента отклоняется с ошибкой о том, что организация выключила доступ AI-агентов, а новые приложения и токены подключить нельзя. После включения все приложения и токены, которые за это время не отозвали и которые не истекли, снова работают без переподключения.
• Видеть и отзывать любое AI-приложение и токен, подключённые к воркспейсу, кто бы их ни подключил. Владелец подключения получает уведомление об отзыве.
• Узнавать о новых подключениях — владельцы и администраторы компании получают уведомление, когда участник подключает AI-приложение или создаёт персональный токен доступа.

Безопасность

Как AltOrbit держит подключённое AI-приложение под контролем:

• Согласие с повторной проверкой — OAuth 2.1 с PKCE. Страница согласия на app.altorbit.app показывает, какое приложение просит доступ, кто за него ручается и куда уйдёт доступ. Подтверждение приложения или создание токена просит подтвердить, что это ты, любым одним способом: passkey (Face ID или отпечаток пальца), привязанным аккаунтом вроде Google, Apple или GitHub, кодом двухфакторной аутентификации, паролем или одноразовым кодом из письма. После входа или подтверждения тебя не спрашивают снова 2 часа; каждое подтверждение приложения или новый токен отсчитывают их заново.
• Короткий доступ — access-токен живёт один час. Refresh-токены меняются при каждом использовании и истекают через 30 дней без использования и не позже чем через 365 дней.
• Персональные токены доступа показываются один раз, истекают через 90 дней без использования и не позже чем через 365 дней (или раньше, если так выберешь) и имеют постоянный префикс ao_pat_, чтобы сканеры секретов замечали утёкший токен.
• Секреты не хранятся — токены лежат только в виде ключевых хешей; чтобы их различать, мы показываем последние четыре символа.
• Проверка на каждом вызове — членство, роль и клиентский доступ читаются заново каждый раз, поэтому потеря доступа в AltOrbit сразу отключает AI-приложение.
• События аккаунта касаются агентов — сброс пароля, изменение двухфакторного входа или выход из всех остальных сессий тоже отключают все AI-приложения и токены. Когда владелец или администратор компании выключает AI-подключения для воркспейса, они не отключаются, а ставятся на паузу — см. Управление на уровне воркспейса.
• Аудит — действия, которые AltOrbit записывает в аудит, когда их делаешь ты в приложении (например, изменения тикетов, доски и запросов), записываются и тогда, когда их делает AI-приложение, вместе с отклонёнными попытками. В каждой записи — инструмент, подключение и имя, которым приложение назвало себя.
• Отметка в истории тикета — каждая сохранённая версия тикета говорит, откуда пришло изменение: из приложения, клиентского портала или MCP.
• Контент — это данные — AltOrbit говорит модели считать названия, описания и комментарии данными, а не инструкциями, и помечает инструменты, которые что-то меняют, чтобы клиент мог сначала спросить тебя. Права при этом в любом случае проверяет сервер.
• Лимиты запросов — у AI-приложения те же лимиты на пользователя, что и у тебя в приложении.

Отзыв доступа

• Подключённые приложения — в веб-приложении открой Настройки › AI-агенты и нажми Отключить рядом с приложением. Его токены сразу перестают работать; чтобы снова им пользоваться, подключи и подтверди его заново.
• Персональные токены доступа — там же нажми Отозвать. Любой инструмент с этим токеном сразу перестаёт работать.
• Владельцы и администраторы компании могут отозвать любое приложение или токен, подключённые к воркспейсу, или поставить их все на паузу, выключив AI-подключения, — см. Управление на уровне воркспейса.
• Удаление аккаунта AltOrbit удаляет все твои подключения и токены. AltOrbit можно убрать и из AI-клиента, но закрывает доступ только отзыв в самом AltOrbit.

Если что-то не так

Поддержка и приватность

Вопросы и проблемы с коннектором — пиши на support@altorbit.app или через форму на странице поддержки. Как мы обращаемся с данными, когда ты подключаешь AI-приложение, описано в Политике конфиденциальности; сообщения об уязвимостях — на security@altorbit.app.