Zasoby
SwiftXEO udostępnia REST API dla obszarów roboczych, serwer MCP z obsługą OAuth oraz podpisane webhooki przychodzące. Wszystkie operacje zapisu działają wyłącznie w trybie propozycji (propose-only), a zatwierdzanie pozostaje domeną zalogowanych ludzi.
Połącz modele Claude, ChatGPT, Cursor lub własny system z zatwierdzonym DNA Biznesu, celami i aktywnymi regułami. Przesyłaj dowody i propozycje podlegające tej samej weryfikacji przez człowieka, co pozostałe elementy.
Kluczowa zasada
Agent połączony przez API lub MCP odczytuje zatwierdzony kontekst określony w uprawnieniach klucza: DNA Biznesu, aktywne reguły, cele i historię powiązań. Może zgłaszać kwestie do weryfikacji i proponować wnioski. Nie może jednak samodzielnie uznać swoich wniosków za obowiązujące.
Żaden zakres uprawnień, narzędzie ani webhook nie ma możliwości zatwierdzenia ani aktywowania reguły. Odbywa się to wewnątrz SwiftXEO, przez uprawnioną osobę, zgodnie z lokalnymi zasadami weryfikacji. Aktywacja reguły wymaga uprawnień administratora lub właściciela obszaru roboczego.
Zasady Otwartej Platformy
Dostęp powiązany z poświadczeniami
Przestrzeń robocza jest określana na podstawie klucza. Nie można jej wybrać ani nadpisać za pomocą parametru żądania.
Odczyt zatwierdzonego kontekstu
DNA Biznesu, aktywne reguły, cele i powiązania — ten sam rejestr, który w produkcie widzi człowiek.
Proponuj, nigdy nie zatwierdzaj
Zewnętrzne zapisy trafiają do kolejki oczekujących. Żaden zakres nie sięga ścieżki autoryzacyjnej.
Podpisany odbiór dowodów
Ładunki webhooków są weryfikowane za pomocą HMAC i zapisywane jako powiązany kontekst do weryfikacji — nigdy nie są wykonywane.
Domyślnie niezaufane
Zewnętrzne materiały są przy odbiorze oznaczane jako niezaufane. Podniesienie ich statusu to za każdym razem decyzja człowieka.
Dane filtrowane, nie surowe
Odpowiedzi stanowią projekcję opartą na regułach dozwolonych danych. Identyfikatory wewnętrzne pozostają wewnątrz; weryfikatorzy widoczni są jako etykiety ról, nie nazwiska.
Uwierzytelnianie
Wygeneruj klucz API przestrzeni roboczej w Ustawienia → Infrastruktura → Dostęp do Otwartej Platformy (wymagany administrator przestrzeni roboczej). Unikalny ciąg znaków (secret) pojawia się tylko raz; przechowywany jest wyłącznie jego hash. Zakresy odczytu są dostępne od planu Growth; zakresy zapisu wymagają planu Execution i są weryfikowane przy użyciu, dzięki czemu zmiana planu zaczyna obowiązywać przy następnym żądaniu.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Migawka DNA Biznesu, aktywne reguły, cele i historia powiązań
Wyszukiwanie w przestrzeni roboczej po tematach, słowach kluczowych, kampaniach, briefach i konkurencji
Proponowanie wniosków — zawsze trafia ze statusem PENDING do kolejki weryfikacji
Przesyłanie dowodów, sygnałów lub dokumentów jako powiązanego kontekstu
Generowanie treści podlegających weryfikacji — pobiera kredyty obszaru roboczego
Growth = korzystanie z zatwierdzonych wytycznych · Execution = udział w nadzorowanym przepływie pracy
REST API v1
Każda odpowiedź używa tego samego formatu — { data, meta? } w przypadku sukcesu, { error: { code, message } } w przypadku błędu. Odczyty są ograniczone do 60 żądań na minutę na przestrzeń roboczą, zapisy do 20. Generowanie treści odlicza kredyty przed wywołaniem modelu.
Zatwierdzona migawka profilu Business DNA — zwracana poprzez ograniczoną projekcję z listy dozwolonych (allowlist)
Zatwierdzone przez człowieka (aktywne) wnioski, z możliwością filtrowania po typie
Otwarte cele wzrostowe
Dowody, historia zmian i zatwierdzenie danego obiektu przez człowieka
Zaproponuj wniosek — status PENDING do momentu zatwierdzenia przez człowieka
Przesłanie powiązanego kontekstu do weryfikacji
Generowanie treści z weryfikacją (wymaga kredytów). Przekaż persist: true, aby zapisać wynik jako draft z metadanymi dostawcy/zadania; w przeciwnym razie zwracany jest sam tekst
W przypadku dłuższych prac zewnętrznych SwiftXEO może wydać zadanie powiązane z celem, przyjąć wygenerowany wynik i połączyć późniejsze obserwacje z tym samym rekordem.
Kompilacja zadania z ograniczonym kontekstem dla jednego autoryzowanego celu — zdefiniowany zakres, na którym pracuje zewnętrzny agent
Prześlij wynik do zadania — draft, dowód lub proponowany wniosek — ze statusem oczekiwania na weryfikację. Powiązanie zadania z wynikiem jest sprawdzane po stronie serwera; nieprawidłowe lub nieistniejące identyfikatory są odrzucane
Zgłaszanie obserwacji jakościowych lub liczbowych dotyczących wyniku celu — operacja idempotentna, podlegająca weryfikacji przez człowieka
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "content_learnings",
"category": "overclaim",
"lesson": "Avoid absolute performance claims without evidence.",
"evidenceNote": "Three campaign replies flagged the launch copy as overstated."
}'Serwer MCP
Punkt końcowy /api/mcp obsługuje bezstanowy, strumieniowy protokół HTTP. Do przetestowanych klientów hostowanych należą obecnie Claude (wersje przeglądarkowa, desktopowa i mobilna) oraz ChatGPT, które łączą się przez OAuth: wklej adres URL, zaloguj się, wybierz obszar roboczy i zatwierdź dostęp. Klienci korzystający z plików konfiguracyjnych, tacy jak Claude Code czy Cursor, używają statycznego klucza obszaru roboczego.
Lista narzędzi jest filtrowana według zakresów (scopes) połączenia: narzędzia do odczytu zwracają zatwierdzony kontekst, a narzędzia do zapisu służą wyłącznie do zgłaszania propozycji. Celowo na żadnym poziomie zakresu nie istnieje narzędzie do zatwierdzania, aktywacji ani autoryzacji.
Claude Code, Cursor i inne klienty plikowe
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
Claude web, Desktop, mobile i ChatGPT
Dodaj własny konektor URL: https://www.swiftxeo.com/api/mcp → Zaloguj się do SwiftXEO, wybierz przestrzeń roboczą, zatwierdź dostęp. Brak klucza do wklejenia — to połączenie używa OAuth.
Dostępne narzędzia
Aktualizacje wersji roboczej pozostają jedynie modyfikacjami wersji roboczej. Zewnętrzne korekty nie mogą zatwierdzać, autoryzować, blokować ani publikować artefaktu, a zmodyfikowana wersja robocza musi przejść ponowną weryfikację, zanim będzie można przejść dalej.
Ograniczenia
Klucz API lub połączenie MCP/OAuth przyznaje określony, przychodzący dostęp do REST API i narzędzi SwiftXEO — nic więcej. Nie rejestruje podmiotu wywołującego jako członka zespołu w Agent Room i nigdy nie przyznaje widoczności dla wzmianek (@mention) w przestrzeni roboczej Agent Room.
Asystenci w Agent Room to stały, zamknięty zespół: Claude, OpenAI, Gemini, Doradca SwiftXEO oraz Weryfikator. Każdy posiada własne reguły routingu i dostępu, których nie da się obejść zewnętrznymi danymi uwierzytelniającymi.
Protokół Local Connector jest powiązany, ale odrębny. Łączy lokalne środowisko (np. Mac wykonujący zadania w Agent Room) z własnym poświadczeniem, licencją i cyklem unieważniania. Różni się to zarówno od kluczy API, jak i połączeń MCP.
Przychodzące webhooki
Utwórz źródło przychodzące w sekcji Ustawienia → Infrastruktura → Źródła przychodzące, aby otrzymać dedykowany punkt końcowy i sekret do składania podpisu. Każdy payload jest weryfikowany za pomocą HMAC-SHA256 na surowej treści (raw body), zanim trafi jako powiązany kontekst — materiał do weryfikacji przez człowieka, nigdy samodzielne źródło prawdy. Błąd weryfikacji powoduje odrzucenie żądania przed przetworzeniem lub zapisaniem czegokolwiek.
Plan Growth obejmuje jedno aktywne źródło; Execution pozwala na wiele źródeł.
POST /api/hooks/{workspaceId}/{sourceId}
X-Signature: sha256=<hmac of raw body>
{
"kind": "signal",
"title": "CRM: deal closed",
"body": "Acme signed the annual
plan after the Q3 campaign."
}Pytania
Nie. Żadne uprawnienie API, narzędzie MCP ani webhook nie może oznaczyć propozycji jako zatwierdzonej ani wywołać ścieżki zatwierdzenia. Systemy zewnętrzne mogą odczytywać zatwierdzony kontekst, dodawać dowody i proponować wnioski. Każda propozycja trafia do kolejki oczekujących, a aktywacja reguły wymaga zalogowanego administratora lub właściciela obszaru roboczego.
Dwa typy poświadczeń w tym samym nagłówku bearer: statyczny klucz API przestrzeni roboczej dla klientów plikowych lub token dostępowy OAuth dla klientów hostowanych, takich jak Claude i ChatGPT. W obu przypadkach przestrzeń robocza wynika z poświadczeń — nigdy z argumentów narzędzia.
Plan Growth obejmuje operacje odczytu: DNA Biznesu, cele, aktywne reguły, powiązania i wyszukiwanie, a także jedno przychodzące źródło webhook. Plan Execution dodaje operacje zapisu: proponowanie wniosków, przesyłanie dowodów, generowanie treści z weryfikacją i obsługę wielu webhooków.
Wyłącznie etykiety ról. Zewnętrzne odpowiedzi są przesyłane przez warstwę anonimizacji: tożsamości weryfikatorów i autorów zmieniają się na „Administrator przestrzeni roboczej”, a wewnętrzne identyfikatory są usuwane, zanim cokolwiek opuści przestrzeń roboczą.
Pełna dokumentacja platformy znajduje się w bazie wiedzy. Strona Otwartej Platformy wyjaśnia model weryfikacji egzekwowany przez te punkty końcowe.