# API obejmuje wszystko, co jest w interfejsie

Każdy ekran Krokul działa na tym samym API, które jest otwarte dla ciebie: klucze z uprawnieniami ról, webhooki z ponowieniami, dokumentacja generowana z kodu i MCP dla agentów AI.

**W skrócie.** Krokul to CRM B2B z publicznym API v1, które obejmuje wszystkie dane i działania interfejsu, ponieważ sam interfejs na nim działa. Klucze API tworzy się z uprawnieniami roli i dziennikiem wywołań; webhooki wysyłają zdarzenia (szansa sprzedaży, dokument, płatność, firma klienta) z kolejką dostarczania, ponowieniami i dziennikiem; dokumentacja po angielsku jest generowana ze specyfikacji w kodzie i zawiera przykłady z prawdziwych odpowiedzi; serwer MCP pozwala agentom AI czytać dane i działać w granicach uprawnień klucza. Wszystko to jest częścią produktu, bez osobnego wyższego planu.

**Plan:** Dostępne od planu Pieniądze, $149 miesięcznie; MCP i wyższe limity w planie Marża

## Jak to wygląda bez Krokul

2. Webhook nie dotarł, bo serwer klienta leżał przez trzy minuty. Zdarzenie przepadło, zamówienie nie powstało i nikt tego nie zauważył.
3. API jest tylko w drogim planie, a dokumentacja to trzy strony bez przykładów. Integracja kosztuje więcej niż CRM.

## Co robi Krokul

### Jedno API dla ekranu i dla ciebie

Interfejs Krokul wywołuje te same endpointy, które otwiera klucz API. Pole, które widzisz na ekranie, jest też w API, z założenia konstrukcyjnego.

### Klucze z uprawnieniami ról

Klucz tworzy się dla roli: handlowiec, księgowa, tylko odczyt. Czego nie może rola, tego nie może klucz; każde wywołanie trafia do dziennika.

### Webhooki z kolejką

Zdarzenia dotyczące szans, dokumentów, płatności i firm klientów trafiają na twój adres URL z kolejką, ponowieniami przy błędzie i dziennikiem dostarczeń. Niedostarczone zdarzenia widać i można je wysłać ponownie ręcznie.

### Dokumentacja z kodu i MCP

Specyfikacja powstaje z kodu, a przykłady z prawdziwych odpowiedzi, więc dokumentacja się nie starzeje. Serwer MCP podłącza agentów AI z tymi samymi uprawnieniami co klucz.

## Jak to działa

1. **Utwórz klucz dla roli** W ustawieniach: nazwa, rola, termin ważności. Klucz widzi dokładnie to, co widziałaby osoba z tą rolą.
2. **Przeczytaj dokumentację z przykładami** Dokumentacja po angielsku z opisem każdego endpointu i jego pól, z przykładami odpowiedzi, pod adresem z linku w stopce strony.
3. **Podłącz webhooki** Adres URL i zdarzenia; dziennik dostarczeń pokazuje każdą próbę z kodem odpowiedzi. Przy błędzie ponawia według harmonogramu albo ręcznie.
4. **Podłącz agenta przez MCP** Klucz i adres MCP, a zewnętrzny agent AI czyta dane i proponuje działania w granicach swoich uprawnień, z tym samym dziennikiem.

## Efekt

- Żadne zdarzenie nie przepada: kolejka i ponowienia dostarczają webhook, a dziennik pokazuje każdą próbę.
- API, webhooki i MCP nie mają osobnej ceny: są częścią produktu.

## Czego nie obejmuje

## Pytania

### Czy API naprawdę obejmuje wszystko?

Tak, bo interfejs działa na tych samych endpointach: nie mamy osobnego „wewnętrznego” API z większymi możliwościami.

### Jak ograniczyć, co widzi klucz?

Rolą. Klucz tylko do odczytu niczego nie utworzy; klucz z rolą handlowca nie zobaczy kosztów. Pilnuje tego serwer.

### Co, jeśli webhook nie dotrze?

Dziennik dostarczeń pokazuje próbę i kod odpowiedzi; ponowienie następuje automatycznie według harmonogramu albo ręcznie przyciskiem.

### Czym jest MCP i do czego mi się przyda?

To protokół, którym agenci AI czytają dane i wywołują działania. Krokul ma własny serwer MCP: podłącz agenta kluczem, a zobaczy dokładnie to, na co pozwala rola.

### Ile kosztuje API?

API, klucze i webhooki są w planie Pieniądze, $149 miesięcznie; MCP i wyższe limity wywołań w planie Marża. Rekordy utworzone przez API liczą się jako transakcje tak samo jak te utworzone na ekranie.

### Jak podłączyć usługę, której nie ma w Marketplace?

Własną regułą integracji: Kro układa ją na podstawie opisu, reguła jest testowana na przykładowych zdarzeniach i można ją włączyć dopiero po teście. Usługa wysyła zdarzenie na adres reguły — Krokul znajduje szansę, dokument lub kontakt i tworzy płatność, kontakt lub zadanie; każde zdarzenie zostaje w dzienniku. Własne reguły są w planie Margin.

## Otwórz dokumentację i wyślij pierwsze żądanie

Utwórz klucz w ustawieniach, wywołaj endpoint „firmy klientów” i odbierz swoją listę w pięć minut, bez pisania do wsparcia.

W cenie planu Pieniądze.

## Dalej w łańcuchu

- [Automatyzacje: system robi rutynę i pokazuje, dlaczego](https://krokul.com/pl/solutions/automations/index.md)
- [Rola decyduje, kto co widzi. Serwer tego pilnuje](https://krokul.com/pl/solutions/security/index.md)
- [Twoje dane są twoje: API, eksport i wycofanie od pierwszego dnia](https://krokul.com/pl/solutions/data/index.md)
- [Asystent AI, który konfiguruje system zwykłymi słowami](https://krokul.com/pl/solutions/assistant/index.md)

---

Aplikacja: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs