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.