Zasoby
SwiftXEO udostępnia REST API o zasięgu przestrzeni roboczej, serwer MCP z OAuth oraz podpisane webhooki przychodzące — każdy punkt zapisu działa wyłącznie w trybie propozycji, a prawo zatwierdzania pozostaje w rękach zalogowanych ludzi.
Połącz Claude, ChatGPT, Cursor lub własny system z zatwierdzonym DNA biznesowym, celami i aktywnymi wnioskami — oraz wnoś dowody i propozycje za pośrednictwem tego samego procesu weryfikacji przez człowieka, który zarządza całą resztą.
Główna doktryna
Agent połączony przez API lub MCP może odczytać wszystko, co zostało zatwierdzone w Twojej przestrzeni roboczej, i wykonywać pożyteczną pracę w oparciu o te dane. Może dostrzegać kwestie warte weryfikacji i proponować wnioski przydatne w dalszych działaniach. Nie może jednak samodzielnie uznać, że jego własne konkluzje są poprawne.
Żaden zakres, narzędzie ani ładunek webhooka nie może zatwierdzić ani aktywować wniosku. Ta decyzja zapada jednorazowo wewnątrz produktu, przez administratora przestrzeni roboczej — przez tę samą bramkę przechodzi każda propozycja wygenerowana wewnętrznie.
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 zatwierdzonej prawdy
DNA biznesowe, aktywne wnioski, cele i historia — te same dane, które produkt wyświetla człowiekowi.
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 biznesowego, aktywne wnioski, cele i historia zmian
Wyszukiwanie w przestrzeni roboczej po tematach, słowach kluczowych, kampaniach, briefach i konkurencji
Proponowanie wniosków — zawsze trafia jako OCZEKUJĄCE do kolejki weryfikacji przez człowieka
Przesyłanie dowodów, sygnałów lub dokumentów jako powiązanego kontekstu
Nadzorowane generowanie treści — odlicza kredyty przestrzeni roboczej
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.
Migawka zatwierdzonego DNA biznesowego — filtrowana projekcja oficjalnej wiedzy organizacji
Zatwierdzone przez człowieka (aktywne) wnioski, z możliwością filtrowania według typu
Otwarte cele wzrostowe
Dowody, historia wersji i autoryzacja człowieka dla danej encji
Zaproponowanie wniosku — status OCZEKUJĄCY do momentu zatwierdzenia przez człowieka
Przesłanie powiązanego kontekstu do weryfikacji
Nadzorowane generowanie treści, limitowane kredytami
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_..." \
-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 protokół HTTP. Klienty hostowane — Claude w wersji web, desktop i mobile oraz ChatGPT w trybie deweloperskim — łączą się przez OAuth: wklej URL, zaloguj się, wybierz przestrzeń roboczą i zatwierdź dostęp. Klienty konfigurujące się przez pliki, takie jak Claude Code czy Cursor, używają statycznego klucza przestrzeni roboczej.
Lista narzędzi jest filtrowana według zakresów połączenia: narzędzia odczytu zwracają zatwierdzoną prawdę, narzędzia zapisu wyłącznie proponują. Celowo brak narzędzi do zatwierdzania, aktywacji czy autoryzacji na jakimkolwiek poziomie.
Claude Code, Cursor i inne klienty plikowe
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_..."
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
Przychodzące webhooki
Utwórz źródło przychodzące w Ustawienia → Infrastruktura → Źródła przychodzące, aby otrzymać dedykowany punkt końcowy i klucz podpisujący. Każdy ładunek danych jest weryfikowany za pomocą HMAC-SHA256 na surowej treści, zanim trafi jako powiązany kontekst — materiał do weryfikacji przez człowieka, nigdy samodzielna prawda.
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. Żaden zakres API, narzędzie MCP ani webhook nie może zmienić statusu propozycji na zatwierdzony ani uzyskać dostępu do ścieżki autoryzacyjnej. Zewnętrzne systemy mogą odczytywać zatwierdzone dane, przesyłać dowody i proponować wnioski — każda propozycja trafia do kolejki oczekujących i tylko administrator przestrzeni roboczej zalogowany jako człowiek może ją zatwierdzić.
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.
Growth obejmuje odczyty: DNA biznesowe, cele, aktywne wnioski, historię zmian i wyszukiwanie w przestrzeni roboczej oraz jedno źródło przychodzących webhooków. Execution dodaje zapisy: proponowanie wniosków, przesyłanie dowodów, nadzorowane generowanie treści oraz wiele źródeł przychodzących.
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, a strona Otwartej Platformy wyjaśnia model nadzoru egzekwowany przez te punkty końcowe.