Dokumentacja narzędzi MCP

Dlaczego to ważne

Gdy asystent AI łączy się z kontem Kit, uzyskuje dostęp do zestawu narzędzi. Każde narzędzie wykonuje jedno zadanie — wyświetla oferty pracy, pobiera szczegóły szablonu, zaprasza członka zespołu. Na tej stronie znajduje się dokumentacja każdego narzędzia, dzięki czemu wiadomo, co asystent AI może, a czego nie może zrobić.

Pierwsze kroki

Każdy połączony asystent AI widzi najpierw tę instrukcję:

Rozpocznij od hiring_get_setup_guide, aby poznać możliwości rekrutacyjne tego konta, dostępne szablony i aktualny stan.

Narzędzie przewodnika zwraca statystyki konta oraz dostępne typy etapów, co daje asystentowi kontekst przed podjęciem jakichkolwiek działań.

Narzędzia rekrutacyjne

Konfiguracja i szablony

hiring_get_setup_guide

Zwraca przegląd konfiguracji rekrutacji: liczbę szablonów, aktywne oferty pracy, łączną liczbę kandydatów oraz wszystkie dostępne typy etapów.

Parametry: Brak

Zwraca: Nazwę konta, szybkie statystyki, opisy typów etapów, sugerowane kolejne kroki.

---

hiring_list_templates

Wyświetla wszystkie szablony procesów rekrutacyjnych dostępne na koncie — zarówno szablony systemowe, jak i własne.

Parametry:

Nazwa	Typ	Wymagany	Opis
tag	string	Nie	Filtrowanie szablonów według tagu
published_only	boolean	Nie	Tylko opublikowane szablony (domyślnie: true)

Zwraca: Tablicę szablonów z identyfikatorem, nazwą, tagami, liczbą etapów, typami etapów i liczbą użyć.

---

hiring_get_template

Zwraca pełne szczegóły konkretnego szablonu, w tym każdy etap i jego konfigurację.

Parametry:

Nazwa	Typ	Wymagany	Opis
template_id	integer	Tak	Identyfikator szablonu z hiring_list_templates

Zwraca: Metadane szablonu, uporządkowane etapy z typem/konfiguracją oraz powiązane szablony e-mail.

---

hiring_create_process_template

Tworzy szablon procesu rekrutacyjnego z podanymi etapami. Zwraca nazwę szablonu, liczbę etapów i adres URL do edycji.

Parametry:

Nazwa	Typ	Wymagany	Opis
name	string	Tak	Nazwa szablonu (np. “Software Engineer Hiring”)
stages	array	Tak	Tablica obiektów etapów, każdy z name (string), type (string), opcjonalnym config (object) i opcjonalnym reviewers (tablica {email, role})
description	string	Nie	Krótki opis szablonu
tags	array	Nie	Tagi do kategoryzacji

Zwraca: Identyfikator szablonu, nazwę, liczbę etapów i adres URL do edycji.

Wymaga: Aktywnej subskrypcji.

---

Oferty pracy

hiring_list_job_postings

Wyświetla wszystkie oferty pracy ze statusem i liczbą aplikacji. Można filtrować według statusu.

Parametry:

Nazwa	Typ	Wymagany	Opis
status	string	Nie	draft, published, paused, closed lub active

Zwraca: Tablicę ofert z identyfikatorem, tytułem, działem, lokalizacją, statusem, liczbą etapów, podsumowaniem aplikacji (łącznie/aktywne/odrzucone/wycofane) oraz publicznym adresem URL, jeśli oferta jest opublikowana.

---

hiring_get_job_posting

Zwraca wszystkie informacje o konkretnej ofercie pracy: etapy z przypisanymi recenzentami, członków zespołu i statystyki procesu rekrutacyjnego.

Parametry:

Nazwa	Typ	Wymagany	Opis
job_posting_id	integer	Tak	Identyfikator oferty pracy z hiring_list_job_postings

Zwraca: Pełne szczegóły oferty, etapy z nazwiskami recenzentów, członków zespołu z rolami, liczniki procesu (łącznie/aktywne/odrzucone/wycofane/z ofertą).

---

hiring_create_job_posting

Tworzy nową ofertę pracy w statusie roboczym. Zwraca adres URL do edycji, aby można było ją przejrzeć i opublikować w przeglądarce.

Parametry:

Nazwa	Typ	Wymagany	Opis
title	string	Tak	Tytuł stanowiska
description	string	Tak	Opis stanowiska w formacie markdown (bez tytułu)
department	string	Nie	Nazwa działu
location	string	Nie	Lokalizacja
employment_type	string	Nie	full_time, part_time, contract lub internship
remote	boolean	Nie	Czy stanowisko zdalne?
process_template_id	integer	Nie	Identyfikator szablonu do zastosowania etapów rekrutacji
salary_min	integer	Nie	Minimalne wynagrodzenie
salary_max	integer	Nie	Maksymalne wynagrodzenie
salary_currency	string	Nie	Kod waluty (np. USD, EUR)
salary_period	string	Nie	Okres (np. year, month)

Zwraca: Identyfikator nowej oferty, tytuł, status (zawsze “draft”) i adres URL do edycji.

Wymaga: Aktywnej subskrypcji.

Uwaga: To narzędzie jest obecnie dostępne tylko przez wbudowany chatbot AI, nie przez zewnętrznych klientów MCP.

---

Aplikacje i proces rekrutacyjny

hiring_list_applications

Wyświetla złożone aplikacje z opcjonalnymi filtrami daty, statusu i oferty pracy. Służy do przeglądania nowych kandydatów, podziału procesu według etapów lub filtrowania według zakresu dat.

Parametry:

Nazwa	Typ	Wymagany	Opis
date_range	string	Nie	this_week, last_week, this_month, last_month, last_7_days lub last_30_days
since	string	Nie	Własna data początkowa (ISO 8601, np. 2025-01-01)
until	string	Nie	Własna data końcowa (ISO 8601, np. 2025-01-31)
status	string	Nie	active, rejected, withdrawn, offered lub all (domyślnie: all)
job_posting_id	integer	Nie	Filtrowanie do konkretnej oferty pracy

Zwraca: Liczniki według statusu, podział według oferty pracy i etapu oraz tablicę aplikacji z imieniem i nazwiskiem kandydata, adresem e-mail, tytułem stanowiska, bieżącym etapem, statusem i czasem złożenia.

---

hiring_get_application_summary

Zwraca kontekst aplikacji do wstępnej selekcji: informacje o kandydacie, bieżący etap, pełną historię etapów ze zgłoszeniami, odpowiedzi na formularze i wartości szybkich pól.

Parametry:

Nazwa	Typ	Wymagany	Opis
application_id	integer	Tak	Identyfikator aplikacji z hiring_list_reviews lub hiring_list_applications

Zwraca: Dane kandydata, ofertę pracy, status aplikacji, bieżący etap, chronologiczną historię etapów z podsumowaniami zgłoszeń, odpowiedzi na formularze i wartości szybkich pól.

---

hiring_get_stage_details

Zwraca szczegółowe informacje specyficzne dla danego typu etapu w ramach pojedynczego postępu etapu. Obejmuje szczegóły oferty, harmonogram rozmów kwalifikacyjnych, status zadania programistycznego, zagregowane oceny, informacje o nagraniu wideo oraz rozbudowane dane zgłoszeń. Należy używać po hiring_get_application_summary, aby zagłębić się w konkretny etap.

Parametry:

Nazwa	Typ	Wymagany	Opis
stage_progress_id	integer	Tak	Identyfikator postępu etapu z historii etapów hiring_get_application_summary

Zwraca: Metadane etapu ze statusem i czasem trwania, kontekst kandydata i oferty pracy, wszystkie zgłoszenia oraz pola specyficzne dla typu etapu — warunki oferty, szczegóły rozmowy kwalifikacyjnej, konfigurację zadania programistycznego, zagregowane oceny, konfigurację nagrania wideo, pytania kwestionariusza lub konfigurację portfolio, w zależności od typu etapu.

---

hiring_advance_application

Przenosi aplikację do następnego etapu w procesie rekrutacyjnym lub do konkretnego etapu, jeśli podano stage_id. Powiadomienia do kandydata i zespołu są wysyłane automatycznie.

Parametry:

Nazwa	Typ	Wymagany	Opis
application_id	integer	Tak	Aplikacja do przeniesienia
stage_id	integer	Nie	Przeniesienie do konkretnego etapu (pomija etapy pośrednie). Jeśli pominięty, przenosi do następnego etapu w kolejności.

Zwraca: Identyfikator aplikacji, imię i nazwisko kandydata, poprzedni etap, nazwę i typ nowego etapu.

Wymaga: Zakresu uprawnień mcp_write.

---

hiring_reject_application

Odrzuca aplikację. Kandydat zostaje powiadomiony e-mailem (z uwzględnieniem ustawienia opóźnienia e-maila o odrzuceniu na koncie). Przed odrzuceniem należy zawsze potwierdzić z użytkownikiem.

Parametry:

Nazwa	Typ	Wymagany	Opis
application_id	integer	Tak	Aplikacja do odrzucenia
reason	string	Nie	Wewnętrzny powód odrzucenia (niewidoczny dla kandydata)

Zwraca: Identyfikator aplikacji, imię i nazwisko kandydata, tytuł oferty pracy, powód i osobę odrzucającą.

Wymaga: Zakresu uprawnień mcp_write.

---

Oceny

hiring_list_reviews

Zwraca skrzynkę odbiorczą ocen w trzech sekcjach: aplikacje wymagające wstępnej selekcji, oceny w kolejce oraz ukończone oceny.

Parametry:

Nazwa	Typ	Wymagany	Opis
section	string	Nie	screening, my_queue lub completed

Zwraca: Trzy tablice (needs_screening, my_queue, completed_reviews) z imionami i nazwiskami kandydatów, tytułami stanowisk, informacjami o etapie i czasem oczekiwania. Zawiera liczniki dla każdej sekcji.

---

hiring_get_review_details

Zwraca wszystko, czego recenzent potrzebuje do oceny kandydata na danym etapie: informacje o kandydacie, zgłoszenia, kryteria punktacji oraz inne oceny (z uwzględnieniem zasad widoczności przy ślepej ocenie).

Parametry:

Nazwa	Typ	Wymagany	Opis
stage_progress_id	integer	Tak	Identyfikator postępu etapu z hiring_list_reviews

Zwraca: Informacje o kandydacie, ofertę pracy, szczegóły etapu, wszystkie zgłoszenia (odpowiedzi na formularze, kod, pliki, wideo itp.), kryteria punktacji z wagami, postęp oceny, własną ocenę (jeśli istnieje) oraz inne oceny (gdy są widoczne).

---

Pula talentów

hiring_list_talent_pool

Wyświetla zweryfikowane wpisy w puli talentów ze skróconymi podsumowaniami ekstrakcji CV. Stronicowanie po 25 wpisów na stronę. Do filtrowania według umiejętności lub doświadczenia należy używać hiring_search_talent_pool.

Parametry:

Nazwa	Typ	Wymagany	Opis
page	integer	Nie	Numer strony (domyślnie: 1, 25 wpisów na stronę)

Zwraca: Łączną liczbę, informacje o stronicowaniu oraz tablicę wpisów z adresem e-mail, datą weryfikacji, podsumowaniem ekstrakcji CV i datą utworzenia.

---

hiring_search_talent_pool

Przeszukuje pulę talentów według umiejętności, doświadczenia lub adresu e-mail za pomocą wyszukiwania semantycznego i tekstowego. Zwraca szczegółowe ekstrakcje CV dla pasujących wpisów.

Parametry:

Nazwa	Typ	Wymagany	Opis
query	string	Tak	Zapytanie (umiejętności, słowa kluczowe dotyczące doświadczenia lub adres e-mail)
limit	integer	Nie	Maksymalna liczba wyników (domyślnie: 10, maks.: 25)

Zwraca: Pasujące wpisy z adresem e-mail, datą weryfikacji, szczegółową ekstrakcją CV i datą utworzenia.

---

hiring_invite_talent_pool

Zaprasza kandydata z puli talentów do aplikowania na konkretną ofertę pracy. Wysyła e-mail z linkiem do wstępnie wypełnionej aplikacji.

Parametry:

Nazwa	Typ	Wymagany	Opis
talent_pool_entry_id	integer	Tak	Identyfikator wpisu w puli talentów z hiring_list_talent_pool lub hiring_search_talent_pool
job_posting_id	integer	Tak	Identyfikator oferty pracy z hiring_list_job_postings

Zwraca: Identyfikator zaproszenia, adres e-mail kandydata, tytuł stanowiska, osobę zapraszającą i adres URL zaproszenia.

Wymaga: Zakresu uprawnień mcp_write.

---

Wideo

hiring_search_video_transcripts

Przeszukuje transkrypcje rozmów wideo według słów kluczowych za pomocą wyszukiwania semantycznego i tekstowego. Zwraca informacje o kandydacie, szczegóły wideo i odpowiednie fragmenty transkrypcji.

Parametry:

Nazwa	Typ	Wymagany	Opis
query	string	Tak	Słowa kluczowe do wyszukania w transkrypcjach
job_posting_id	integer	Nie	Filtrowanie wyników do konkretnej oferty pracy
limit	integer	Nie	Maksymalna liczba wyników (domyślnie: 10, maks.: 20)

Zwraca: Pasujące transkrypcje wideo z informacjami o kandydacie, szczegółami wideo i odpowiednimi fragmentami.

---

Narzędzia zespołowe

team_list_members

Wyświetla wszystkich członków bieżącego konta wraz z ich rolami.

Parametry: Brak

Zwraca: Tablicę członków z imieniem i nazwiskiem, adresem e-mail, rolami i flagą właściciela.

---

team_list_invitations

Wyświetla wszystkie oczekujące zaproszenia dla bieżącego konta.

Parametry: Brak

Zwraca: Tablicę zaproszeń z imieniem i nazwiskiem, adresem e-mail, przypisanymi rolami, osobą zapraszającą i datą.

---

team_invite_member

Wysyła e-mail z zaproszeniem do dołączenia do konta. Tylko administratorzy konta mogą korzystać z tego narzędzia.

Parametry:

Nazwa	Typ	Wymagany	Opis
email	string	Tak	Adres e-mail do zaproszenia
name	string	Tak	Imię i nazwisko zaproszonej osoby
admin	boolean	Nie	Przyznanie roli administratora (domyślnie: false)

Zwraca: Potwierdzenie z adresem e-mail, imieniem i nazwiskiem, przypisaną rolą i statusem.

Wymaga: Zakresu uprawnień mcp_write, roli administratora i aktywnej subskrypcji.

Narzędzia Outreach

Te narzędzia wymagają dodatku Outreach i aktywnej subskrypcji.

outreach_list_campaigns

Wyświetla kampanie outreach z opcjonalnym filtrem statusu. Zwraca do 25 kampanii.

Parametry:

Nazwa	Typ	Wymagany	Opis
status	string	Nie	Filtrowanie według draft, active, paused lub completed

Zwraca: Tablicę kampanii z identyfikatorem, nazwą, statusem, prospect_count, message_count, pending_draft_count i created_at.

---

outreach_get_campaign

Zwraca pełne szczegóły konkretnej kampanii, w tym konfigurację, liczbę prospektów według statusu, podsumowanie wiadomości i liczbę odpowiedzi.

Parametry:

Nazwa	Typ	Wymagany	Opis
campaign_id	string	Tak	Identyfikator kampanii z outreach_list_campaigns

Zwraca: Identyfikator kampanii, nazwę, status, pełną konfigurację (docelowa liczba, dyrektywy AI, kroki sekwencji), liczbę prospektów według statusu, podsumowanie wiadomości (łącznie, oczekujące wersje robocze, wysłane), liczbę odpowiedzi i created_at.

---

outreach_add_prospect

Dodaje prospekta do kampanii. Sprawdza duplikaty i wstrzymane adresy e-mail, chyba że ustawiono force.

Parametry:

Nazwa	Typ	Wymagany	Opis
campaign_id	string	Tak	Kampania, do której dodawany jest prospekt
email	string	Tak	Adres e-mail prospekta
first_name	string	Nie	Imię prospekta
last_name	string	Nie	Nazwisko prospekta
company_name	string	Nie	Nazwa firmy
title	string	Nie	Stanowisko
source_url	string	Nie	Profil LinkedIn lub adres URL firmy do badania przez AI
notes	string	Nie	Dodatkowy kontekst tekstowy dla agenta AI
force	boolean	Nie	Pominięcie sprawdzania duplikatów i wstrzymań (domyślnie: false)

Zwraca: Identyfikator prospekta, adres e-mail i status.

Wymaga: Zakresu uprawnień mcp_write.

---

outreach_draft_email

Kolejkuje badanie AI i tworzenie wersji roboczej wiadomości dla konkretnego prospekta. Prospekt musi być w stanie umożliwiającym tworzenie wersji roboczej (jeszcze nie przygotowany ani aktywny).

Parametry:

Nazwa	Typ	Wymagany	Opis
prospect_id	string	Tak	Prospekt, dla którego przeprowadzić badanie i przygotować wersję roboczą

Zwraca: Potwierdzenie, że badanie zostało dodane do kolejki.

Wymaga: Zakresu uprawnień mcp_write.

---

outreach_list_pending_drafts

Wyświetla wersje robocze wiadomości oczekujące na zatwierdzenie, opcjonalnie filtrowane według kampanii. Zwraca do 25 wersji roboczych.

Parametry:

Nazwa	Typ	Wymagany	Opis
campaign_id	string	Nie	Filtrowanie do konkretnej kampanii

Zwraca: Tablicę wersji roboczych z identyfikatorem, nazwą kampanii, imieniem i nazwiskiem prospekta, tematem, podglądem treści (200 znaków) i created_at.

---

Narzędzia pomocnicze

echo

Testuje połączenie MCP. Odsyła wiadomość z powrotem wraz z kontekstem konta.

Parametry:

Nazwa	Typ	Wymagany	Opis
message	string	Tak	Wiadomość do odesłania

Zwraca: Wiadomość użytkownika, nazwę konta, adres e-mail, zakresy uprawnień i znacznik czasu.

---

search_docs

Przeszukuje dokumentację produktu Kit. Przydatne, gdy asystent jest pytany o działanie funkcji.

Parametry:

Nazwa	Typ	Wymagany	Opis
query	string	Tak	Czego szukać

Zwraca: Pasujące strony dokumentacji z tytułem, kategorią i treścią.

---

get_plans

Pobiera aktualne plany cenowe z funkcjami, szczegółami cen i informacjami rozliczeniowymi.

Parametry: Brak

Zwraca: Tablicę planów z nazwą, opisem, ceną, walutą, okresem rozliczeniowym, flagą opłaty za miejsce, dniami okresu próbnego i listą funkcji.

Podsumowanie uprawnień

Narzędzie	Wymagany zakres	Zapis?	Uwagi
echo	—	Nie
search_docs	—	Nie
get_plans	—	Nie
hiring_get_setup_guide	mcp	Nie
hiring_list_templates	mcp	Nie
hiring_get_template	mcp	Nie
hiring_create_process_template	mcp	Tak	Wymaga aktywnej subskrypcji
hiring_list_job_postings	mcp	Nie
hiring_get_job_posting	mcp	Nie
hiring_create_job_posting	—	Tak	Tylko wbudowany chatbot; wymaga aktywnej subskrypcji
hiring_list_applications	mcp	Nie
hiring_get_application_summary	mcp	Nie
hiring_get_stage_details	mcp	Nie
hiring_advance_application	mcp_write	Tak
hiring_reject_application	mcp_write	Tak
hiring_list_reviews	mcp	Nie
hiring_get_review_details	mcp	Nie
hiring_list_talent_pool	mcp	Nie
hiring_search_talent_pool	mcp	Nie
hiring_invite_talent_pool	mcp_write	Tak
hiring_search_video_transcripts	mcp	Nie
team_list_members	mcp	Nie
team_list_invitations	mcp	Nie
team_invite_member	mcp_write	Tak	Tylko administratorzy; wymaga aktywnej subskrypcji
outreach_list_campaigns	mcp	Nie	Wymaga dodatku Outreach
outreach_get_campaign	mcp	Nie	Wymaga dodatku Outreach
outreach_add_prospect	mcp_write	Tak	Wymaga dodatku Outreach
outreach_draft_email	mcp_write	Tak	Wymaga dodatku Outreach
outreach_list_pending_drafts	mcp	Nie	Wymaga dodatku Outreach

Wszystkie narzędzia są ograniczone do połączonego konta. Asystent nigdy nie może wyświetlić ani zmodyfikować danych z innego konta.