CONNECTOR

Słowniczek

Tłumaczymy 28 pojęć, które pojawiają się na stronie CONNECTOR. Bez technicznego żargonu, z przykładami z polskich firm. Jeśli czegoś brakuje - napisz na [email protected], dopiszemy.

Podstawowe pojęcia

Konektor

Gotowy łącznik, który pozwala Twojemu asystentowi AI rozmawiać z Twoim programem (Comarch, Allegro, Fakturownia itd.).

Konektor to mały serwis który mówi w dwóch językach naraz - po jednej stronie rozumie polecenia Twojego asystenta AI (np. Claude), po drugiej potrafi się dogadać z konkretnym programem. Dzięki temu możesz napisać do AI „pokaż faktury z marca” a on sięgnie do Twojego programu księgowego i pokaże je.

Przykład: Konektor KSeF pozwala AI wystawić fakturę głosowo - wpisujesz „wystaw fakturę dla Kowalskiego 1230 zł netto za usługi z marca” i konektor wystawia ją w KSeF.

MCP

aliasy: Model Context Protocol

Standard z listopada 2024 (Anthropic) dzięki któremu AI potrafi rozmawiać z Twoimi programami.

MCP (Model Context Protocol) to standard opracowany przez firmę Anthropic w listopadzie 2024. Dotychczas każdy producent AI miał własny sposób łączenia z programami zewnętrznymi - MCP to ujednolicił. Każdy nowoczesny asystent AI (Claude, ChatGPT i inne) potrafi mówić w MCP - dlatego nasze konektory działają z każdym z nich.

Przykład: Twoja firma używa Claude do pisania maili. Dzięki MCP Claude może też wystawić fakturę w KSeF, sprawdzić saldo w mBanku i odpalić wysyłkę z InPost - bez programisty.

Asystent AI

aliasy: AI agent, AI, agent AI

Twój pomocnik oparty na sztucznej inteligencji - Claude, ChatGPT, Bielik i inne.

Asystent AI to program rozumiejący tekst i potrafiący wykonywać polecenia. Możesz mu mówić jak człowiekowi: „przygotuj raport sprzedaży za marzec” albo „odpowiedz klientowi że dostawa będzie w czwartek”. CONNECTOR daje Twojemu asystentowi AI ręce - dzięki nam asystent nie tylko mówi, ale też wykonuje.

Wywołanie

Pojedyncze pytanie lub polecenie AI do Twojego programu (np. „pokaż faktury z marca”).

Każde wywołanie to jedna konkretna akcja: pobranie listy, wystawienie faktury, sprawdzenie statusu paczki. W cennikach liczymy wywołania - im więcej rozmów AI z Twoimi programami, tym wyższy plan. Większość naszych klientów mieści się w 2 000-10 000 wywołań miesięcznie.

Klient AI (Claude Desktop, Cursor, ChatGPT)

aliasy: Claude Desktop, Cursor, n8n, ChatGPT, Bielik

Program w którym używasz AI i który łączy się z naszymi konektorami.

Klient AI to aplikacja na Twoim komputerze (lub w przeglądarce) w której rozmawiasz z asystentem AI. Najpopularniejsze: Claude Desktop (Anthropic), ChatGPT (OpenAI), Cursor (dla programistów), n8n (do automatyzacji), Bielik (polski LLM). Wszystkie one potrafią łączyć się z naszymi konektorami.

Biznesowe

iPaaS

Platforma online która łączy ze sobą różne programy firmowe.

iPaaS (Integration Platform as a Service) to serwis działający w internecie który łączy ze sobą wiele programów. Zamiast osobno integrować Comarch z Allegro, Allegro z InPost, InPost z mBankiem - łączysz wszystko do iPaaS i ten dba o resztę. CONNECTOR jest pierwszym polskim iPaaS skupionym na AI.

MOAT (przewaga konkurencyjna)

Coś co konkurencja musiałaby skopiować przez wiele lat.

MOAT (fosa zamkowa) to termin biznesowy oznaczający trwałą przewagę nad konkurencją. Mamy 70+ konektorów których nie ma żadna inna platforma na świecie (Workato, Zapier, n8n) - bo to są polskie systemy. Konkurencja musiałaby najpierw poznać polski rynek, polskie prawo, polskie ERP. To zajmie im lata.

Customer Success (opiekun klienta)

aliasy: opiekun klienta

Dedykowany opiekun klienta - pomaga Twojej firmie wycisnąć z CONNECTORA maksimum.

Customer Success Manager to osoba przypisana do Twojej firmy. Nie sprzedaje - pomaga. Dzwoni raz w miesiącu żeby zapytać co działa, co nie, jakie macie potrzeby. Doradza nowe konektory pod Twój scenariusz. W planie Pro+ i wyżej.

Enterprise sales

Długi proces sprzedaży dla dużych firm - prezentacje, rozmowy, negocjacje.

Enterprise sales to model w którym duże firmy (Workato, MuleSoft) sprzedają tylko przez handlowca - 4-6 miesięcy rozmów, prezentacje, negocjacje. CONNECTOR celowo działa inaczej - po prostu zakładasz konto online, płacisz kartą, używasz. Bez handlowca. Stąd nasz slogan: „bez rozmowy z handlowcem”.

Techniczne

API

aliasy: Application Programming Interface

Sposób w jaki dwa programy między sobą rozmawiają.

API (Application Programming Interface) to zestaw zasad dzięki któremu Twój program księgowy potrafi wysłać dane do Allegro, a Allegro potrafi powiadomić Comarch o nowym zamówieniu. Każdy nowoczesny program ma API - my korzystamy z tych API w naszych konektorach, żebyś nie musiał o tym myśleć.

Klucz API

aliasy: kod dostępu, tokeny API

Kod dostępu którym Twój asystent AI legitymuje się przy konektorze.

Klucz API to długi ciąg znaków (np. ck_live_abc123def456...) który pełni rolę hasła między programami. Po założeniu konektora generujesz klucz w panelu CONNECTORA i wklejasz do swojego programu AI (Claude Desktop, ChatGPT, inny). Każdy klucz ma swój zakres uprawnień - możesz dać klucz tylko do czytania albo też do zapisywania.

Przykład: Pracownikowi możesz wygenerować klucz „tylko czytanie magazynu” - sprawdzi stan ale nie zmieni cen.

Endpoint

aliasy: adres konektora, punkt łączenia

Adres techniczny pod którym AI łączy się z konektorem.

Endpoint to URL (adres internetowy) na który Twój asystent AI wysyła zapytania. Wygląda mniej więcej tak: https://mcp.connector.pl/v1/ksef. Wklejasz go do swojego programu AI razem z kluczem dostępu - i gotowe. Nigdy nie musisz go zmieniać ręcznie.

Tool

aliasy: operacja, funkcja, narzędzie

Pojedyncza operacja którą AI może wykonać (np. „wystaw fakturę”).

Tool (po polsku: narzędzie albo operacja) to konkretna funkcja konektora. Konektor KSeF ma kilkanaście toolów: wystaw fakturę, pobierz fakturę, sprawdź status, lista faktur z okresu. Każdy konektor ma średnio 14 toolów - razem we wszystkich 95 konektorach mamy ich 1 330.

Resource

aliasy: zasób

Dane do których AI może sięgnąć w Twoim programie.

Resource (po polsku: zasób) to coś co AI może czytać - lista klientów, magazyn, faktury z marca, statystyki sprzedaży. W przeciwieństwie do toola (akcja), resource jest „tylko do odczytu”. Nasze 95 konektorów daje łącznie ~285 resource'ów.

Prompt

aliasy: szablon polecenia

Gotowe polecenie dla AI z podpowiedziami co napisać (np. „raport sprzedaży tygodniowy”).

Prompt to szablon polecenia. Zamiast za każdym razem pisać AI co ma zrobić, używasz gotowego promptu i wpisujesz tylko parametry. Konektor Comarch ma prompty typu: „Wystaw fakturę dla klienta X”, „Raport sprzedaży za okres Y”, „Sprawdź zaległości płatności”.

Scope (zakres uprawnień)

aliasy: zakres uprawnień

Co dokładnie może robić dany klucz dostępu - czytać czy zmieniać.

Każdy klucz API ma swój scope (zakres uprawnień). Może to być „tylko odczyt” (klucz przeczyta magazyn, ale nic nie zmieni), „odczyt + zapis” (klucz może też wystawiać faktury i edytować dane) albo „pełen dostęp” (klucz może wszystko, łącznie z usuwaniem). Klucze dla pracowników zwykle dają tylko odczyt - dla siebie pełen.

Token

Tymczasowy kod dostępu - jak bilet jednorazowy.

Token to specjalny kod, który pozwala wykonać konkretną operację w określonym czasie. Po zalogowaniu się przez Profil Zaufany dostajemy token od państwa, który potwierdza że to Ty - ważny zwykle 5 minut. Następnie token zostaje wymieniony na klucz dostępu który już zostaje z Tobą.

Webhook

Automatyczne powiadomienie wysyłane przez program gdy coś się zdarzy.

Webhook to odwrotność API. Zamiast Twojego programu pytać Allegro „masz coś nowego?”, Allegro samo dzwoni do Twojego programu i mówi „mam nowe zamówienie”. CONNECTOR potrafi odbierać webhooki z różnych systemów i przekazywać je do Twojego AI - np. „nowy mail od klienta, odpowiedz na niego”.

Przykład: Konfigurujesz webhook od Allegro do CONNECTOR - przy każdym zamówieniu AI dostaje powiadomienie i automatycznie wystawia fakturę w KSeF.

SAML / SCIM

Techniczne standardy do integracji logowania z firmowymi systemami HR (Active Directory, Okta).

SAML i SCIM to dwa standardy używane w dużych firmach do zarządzania użytkownikami. SAML pozwala pracownikom logować się przez firmowy system tożsamości (np. Microsoft Entra). SCIM automatycznie tworzy/usuwa konta CONNECTORA gdy ktoś jest zatrudniany/zwalniany. Potrzebne tylko w planach Business i Enterprise.

Bezpieczeństwo

OAuth

Bezpieczny sposób logowania kontem Google/Apple/Facebook bez podawania głównego hasła.

OAuth to standard logowania który pozwala Ci użyć konta z innego serwisu (np. Google) do logowania do nas - bez pokazywania nam Twojego hasła Google. Google potwierdza nam tylko że to Ty. Możesz w każdej chwili odwołać dostęp w ustawieniach swojego konta Google.

SSO

aliasy: Single Sign-On, jednokrotne logowanie

Jednokrotne logowanie - jedno hasło do wielu serwisów (zwykle przez konto firmowe).

SSO (Single Sign-On) to wygoda dla firm. Pracownik loguje się raz przez Google Workspace albo Microsoft 365 i ma dostęp do wszystkich firmowych narzędzi - CONNECTOR też. Gdy odchodzi z pracy, administrator wyłącza jego konto Google i automatycznie odbiera dostęp wszędzie.

Audit log

aliasy: dziennik historii, log audytowy

Dziennik historii - lista wszystkich akcji ze szczegółami kto, kiedy, co.

Audit log (po polsku: dziennik audytowy) to lista każdej akcji wykonanej w systemie. Kto się zalogował, o której godzinie, z jakiego IP, jaki klucz został użyty, jakiego konektora dotyczyła akcja. To ważne dla audytu RODO, AI Act i kontroli wewnętrznej w firmie.

eIDAS

Europejski standard tożsamości elektronicznej - mObywatel i Profil Zaufany go spełniają.

eIDAS to rozporządzenie UE z 2014 (zaktualizowane 2024) określające jak państwa członkowskie potwierdzają tożsamość obywateli przez internet. Logując się przez mObywatel masz „wysoki poziom uwierzytelnienia eIDAS” - czyli Twoja tożsamość jest potwierdzona dokumentem państwowym, na tym samym poziomie co osobiście w urzędzie.

Self-host (we własnej serwerowni)

aliasy: on-premise, u siebie, własna instalacja

Możliwość zainstalowania CONNECTORA na Twoim sprzęcie, bez wysyłki danych do nas.

Wszystkie konektory mogą być uruchomione albo u nas (zarządzamy wszystkim, Ty się nie martwisz), albo u Ciebie - na własnym serwerze firmowym. Druga opcja oznacza że dane wrażliwe (faktury, klienci) nigdy nie opuszczają Twojej sieci. Wymaga współpracy z informatykiem ale daje pełną kontrolę.

Prawo i regulacje

AI Act

Rozporządzenie UE od sierpnia 2026 - reguluje zastosowanie sztucznej inteligencji w biznesie.

AI Act to pierwsze na świecie kompleksowe prawo regulujące sztuczną inteligencję. Wchodzi w życie od sierpnia 2026 i nakłada na firmy korzystające z AI obowiązki: dokumentacja, ocena ryzyka, audyt log, możliwość wyłączenia AI. CONNECTOR od dnia 1 jest zgodny z AI Act - dlatego dziennik historii zapisuje wszystko.

PSD2

Europejskie prawo bankowe pozwalające aplikacjom (za Twoją zgodą) widzieć Twoje konto.

PSD2 (Payment Services Directive 2) to dyrektywa UE która zmusiła banki do otwarcia swoich API. Dzięki temu CONNECTOR może - za Twoją wyraźną zgodą - sprawdzić saldo Twojego konta w mBanku, pobrać wyciąg, sprawdzić czy klient zapłacił fakturę. Dane są pobierane bezpośrednio z banku, my ich nie przechowujemy.

SLA

aliasy: Service Level Agreement

Pisemna gwarancja ile czasu serwis musi działać (np. 99,9% = max 8h przerwy/rok).

SLA (Service Level Agreement) to formalne zobowiązanie dostawcy serwisu. CONNECTOR gwarantuje 99,9% dostępności w planie Pro+ i 99,95% w Business - co znaczy że w roku możemy mieć maksymalnie 8 godzin / 4 godziny przerwy. Jeśli przekroczymy - dostajesz zwrot proporcjonalny do faktury.

KSeF

Krajowy System eFaktur - obowiązkowy dla firm od 2026 (państwowy system fakturowania).

KSeF to państwowy system w którym od 2026 wszystkie firmy w Polsce muszą wystawiać i odbierać faktury VAT. Nasz konektor KSeF łączy AI bezpośrednio z systemem - wpisujesz polecenie po polsku, AI wystawia fakturę w KSeF i odsyła Ci numer.

Czegoś brakuje?

Napisz na [email protected] albo zobacz pełną pomoc i częste pytania.