Podłączanie asystentów AI

Dlaczego to ważne

MCP (Model Context Protocol) umożliwia asystentom AI, takim jak Claude, bezpośrednią interakcję z kontem Kit — wyświetlanie ogłoszeń o pracę, przeglądanie szablonów, zapraszanie członków zespołu i wiele więcej. Zamiast kopiować dane między przeglądarką a oknem czatu AI, asystent odczytuje i działa na Twoich rzeczywistych danych.

Wymagania

• Konto Kit z dostępem administratora
• Klient MCP: Claude Desktop, Claude Code lub dowolna aplikacja kompatybilna z MCP

Konfiguracja

Przejdź do Integracje > Konfiguracja MCP. Zobaczysz adres URL serwera MCP oraz gotową do skopiowania konfigurację dla każdego klienta.

Claude Code (CLI)

Uruchom w terminalu:

claude mcp add --transport http kit https://startupkit.app/api/v1/mcp

Lub dodaj do pliku konfiguracyjnego .mcp.json:

{
  "mcpServers": {
    "kit": {
      "type": "http",
      "url": "https://startupkit.app/api/v1/mcp"
    }
  }
}

Claude Desktop

Dodaj poniższy fragment do pliku konfiguracyjnego Claude Desktop:

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://startupkit.app/api/v1/mcp"]
    }
  }
}

Claude Desktop wykorzystuje mcp-remote do obsługi procesu autoryzacji OAuth za pośrednictwem lokalnego proxy.

Proces autoryzacji

Gdy klient MCP łączy się po raz pierwszy:

1. Przeglądarka otwiera stronę autoryzacji w Kit
2. Jeśli należysz do wielu kont, wybierasz to, które chcesz podłączyć
3. Wybierasz, do których modułów asystent ma dostęp — oraz czy każdy z nich jest tylko do odczytu, czy do odczytu i zapisu
4. Kit wydaje token przypisany do tego konta i tych modułów
5. Klient zapisuje token i odświeża go automatycznie

Tokeny wygasają po 2 godzinach i są automatycznie odświeżane. Ponowna autoryzacja nie jest wymagana, chyba że dostęp zostanie cofnięty.

Zakresy uprawnień

Dostęp MCP przyznawany jest osobno dla każdego modułu. Każdy moduł ma zakres odczytu oraz (poza analizą wynagrodzeń) zakres zapisu:

Moduł	Zakres odczytu	Zakres zapisu	Czego dotyczy
Hiring	hiring_read	hiring_write	Ogłoszenia o pracę, aplikacje, oceny, pula talentów, szablony oraz narzędzia portalu kariery
CSiRT	csirt_read	csirt_write	Zgłoszenia podatności, triaż, wiadomości od badaczy, nagrody, konfiguracja programu
Outreach	outreach_read	outreach_write	Kampanie, prospekty, szkice e-maili, metryki
Compensation Research	compensation_read	—	Benchmarki wynagrodzeń, trendy rynkowe, porównania ról (tylko do odczytu)
Team	team_read	team_write	Członkowie i zaproszenia

Bazowy zakres mcp jest przyznawany zawsze. Obejmuje wyłącznie narzędzia globalne: wyszukiwanie w dokumentacji, plany cenowe, echo oraz narzędzie do oczyszczania plików PDF.

Ekran zgody

Gdy autoryzujesz połączenie, ekran zgody przeprowadza Cię przez następujące kroki:

1. Wybierz konto — jeśli należysz do wielu kont, wybierz to, które chcesz podłączyć
2. Wybierz dostęp do modułów — każdy moduł pojawia się jako wiersz z przełącznikiem Odczyt | Odczyt i zapis. Zapis jest domyślnie wyłączony; przełącz moduł na Odczyt i zapis tylko wtedy, gdy asystent ma wykonywać działania, a nie tylko podglądać. Moduły z ryzykownymi narzędziami zapisu wyświetlają ostrzeżenie wyjaśniające, co właśnie włączasz.

Moduły, których Twoje konto nie ma, są ukrywane na ekranie zgody. Narzędzia z modułów, do których nie przyznano dostępu, są niewidoczne dla asystenta — nigdy nie pojawiają się na jego liście narzędzi.

Połączenia autoryzowane przed wprowadzeniem zakresów modułów mają pełny dostęp; cofnij je i połącz ponownie, aby je ograniczyć.

Aby zmienić uprawnienia połączenia, cofnij je na stronie Konfiguracja MCP i połącz ponownie — nowa zgoda zastępuje poprzednie uprawnienia.

Zarządzanie podłączonymi klientami

Na stronie Konfiguracja MCP widoczni są wszyscy podłączeni klienci z następującymi informacjami:

• Nazwa aplikacji — klient MCP, który się połączył
• Zakresy — dostęp przyznany dla poszczególnych modułów, pokazany jako etykiety (R — odczyt, RW — odczyt i zapis)
• Data autoryzacji — kiedy nawiązano połączenie
• Ostatnie użycie — kiedy klient ostatnio wywołał narzędzie

Kliknij Cofnij, aby odłączyć klienta. Klient będzie musiał ponownie przejść autoryzację, aby połączyć się ponownie.

W skrócie

• Przejdź do Integracje > Konfiguracja MCP
• Skopiuj konfigurację dla swojego klienta MCP
• Uruchom ją lub wklej do konfiguracji klienta
• Autoryzuj połączenie, gdy otworzy się przeglądarka — wybierz konto i ustaw dostęp do modułów (Odczyt lub Odczyt i zapis) na ekranie zgody
• Przetestuj, wpisując „Jakie mam ogłoszenia o pracę?” w asystencie AI
• Sprawdź, czy połączenie pojawiło się w sekcji Podłączeni klienci