Wdrażaj i zarządzaj aplikacjami Orbit za pomocą agenta AI

Co robi serwer MCP Orbit

Model Context Protocol, w skrócie MCP, daje klientom AI standardowy sposób na odkrywanie i wywoływanie narzędzi. Serwer MCP Orbit udostępnia te same możliwości wdrażania i zarządzania, których używa interfejs Orbit, przez bezstanowy endpoint HTTP pod adresem https://runonflux.com/apps/mcp.

• Sprawdzanie: wyświetlanie planów i posiadanych aplikacji, analiza repozytoriów, przeglądanie oczyszczonych specyfikacji aplikacji, sprawdzanie instancji i statusu wdrożenia, pomiar pojemności sieci oraz odczyt ograniczonych logów.
• Wdrażanie: zwaliduj specyfikację aplikacji, zarejestruj wdrożenie, przetestuj instalację i utwórz autorytatywną płatność Stripe, gdy wymagana jest płatność.
• Sterowanie: uruchamianie buildów oraz zatwierdzone akcje: start, stop, restart, pauza, wznowienie, ponowne wdrożenie lub usunięcie na przypisanych instancjach.
• Utrzymanie: aktualizuj obsługiwane ustawienia aplikacji, zachowuj pozostały okres subskrypcji i przedłużaj aplikację na zatwierdzony czas.

Połącz swojego agenta

Potrzebujesz konta Orbit zalogowanego przez Google lub e-mail oraz klienta MCP obsługującego Streamable HTTP i własne nagłówki autoryzacji. Sesje tylko z portfelem ZelCore i SSP nie mogą obecnie utworzyć połączenia z agentem.

• Zaloguj się do Orbit przez Google lub e-mail.
• Otwórz Panel, a następnie Połącz agenta.
• Wybierz Wygeneruj konfigurację połączenia.
• Skopiuj wygenerowany JSON do konfiguracji swojego klienta MCP.
• Połącz się ponownie z nowo wygenerowaną konfiguracją po wygaśnięciu poświadczenia.

{
  "mcpServers": {
    "orbit": {
      "type": "http",
      "url": "https://runonflux.com/apps/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FIREBASE_ID_TOKEN"
      }
    }
  }
}

Traktuj wygenerowaną konfigurację jak hasło. Nie commituj jej, nie dołączaj do zgłoszeń pomocy technicznej, nie wklejaj do promptów ani nie udostępniaj innej osobie. Wygeneruj konfigurację bezpośrednio w swoim panelu.

Dostępne narzędzia agenta

Bezpieczny workflow wdrożeń

• Zacznij od analizy. Poproś agenta o analizę repozytorium i wyjaśnienie wykrytego środowiska uruchomieniowego, portu, gałęzi i katalogu projektu.
• Weryfikuj przed wdrożeniem. Użyj validate_deployment, aby sprawdzić wygenerowaną specyfikację, wymagane zasoby i wiarygodną cenę sieciową bez rejestrowania czegokolwiek.
• Sprawdzaj wywołania modyfikujące. Wymagaj potwierdzenia w swoim kliencie MCP dla deploy_app, trigger_build, control_instance, update_app i renew_app.
• Zachowaj identyfikator transakcji. Zapisz ID transakcji zwrócone przy wdrożeniu, aktualizacji lub odnowieniu. Identyfikuje wysłaną operację Flux i może służyć do sprawdzenia statusu oraz płatności.
• Sprawdź wynik. Po rejestracji zapytaj o status wdrożenia i instancje. Jeśli aplikacja nie działa poprawnie, przeczytaj ograniczony fragment logu.

Uwierzytelnianie, własność i przechowywanie danych

Każde żądanie weryfikuje token Firebase bearer, wyprowadza tożsamość Flux użytkownika przez FluxCore i tworzy sesję ograniczoną do żądania. Transport MCP jest bezstanowy. Orbit nie tworzy osobnej bazy użytkowników MCP i nie przechowuje długotrwałej sesji agenta.

Firebase, FluxCore, blockchain Flux i most płatniczy Stripe pozostają systemami rekordów. Orbit sprawdza własność aplikacji, zanim zwróci szczegóły aplikacji lub skontaktuje się z przypisanym węzłem. Poświadczenia repozytoriów, sekrety zarządzania, zwykły tekst Enterprise i adresy URL zawierające poświadczenia są maskowane w wynikach narzędzi.

Token Firebase ID jest krótkotrwały. Obecny przepływ połączenia nie zawiera danych do odświeżenia, więc agent nie może po cichu przedłużyć dostępu. Gdy token wygaśnie, wygeneruj nową konfigurację w panelu.

Rozwiązywanie problemów

• Brak autoryzacji: wygeneruj nową konfigurację, upewnij się, że skopiowano cały nagłówek Authorization, i sprawdź, czy konto logujesz się przez Google lub e-mail.
• Nie znaleziono narzędzia: połącz ponownie klienta MCP, aby wykonał wykrywanie narzędzi względem aktualnej wersji serwera.
• Aplikacji nie ma na liście: sprawdź, czy aplikacja należy do tożsamości Flux powiązanej z zalogowanym kontem Firebase i czy jest wdrożeniem Orbit.
• Nie można przeanalizować repozytorium: sprawdź adres URL repozytorium, gałąź, podkatalog oraz dane dostępu do prywatnego repozytorium.
• Wymagana płatność: użyj identyfikatora transakcji zwróconego przez wywołanie modyfikujące, aby utworzyć autorytatywną płatność Stripe.
• Timeout: ponów wywołanie tylko do odczytu raz. Nie powtarzaj wywołania modyfikującego, dopóki nie sprawdzisz zwróconego identyfikatora transakcji lub statusu wdrożenia.