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 — podłączyć może każdy członek zespołu, uprawnienia administratora nie są potrzebne
• Klient MCP: Claude Desktop, Claude Code, Codex CLI, OpenCode lub dowolna aplikacja kompatybilna z MCP

Podłączenie to sprawa osobista: połączenie należy do Ciebie, nie do konta. To, do czego asystent sięgnie, wynika z Twojej roli — z Twoich poziomów dostępu do poszczególnych modułów, sprawdzanych na nowo przy każdym wywołaniu. Dlatego dwie osoby, które podłączą tego samego klienta do tego samego konta, dostaną różne zestawy narzędzi.

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.

Codex CLI

Dodaj serwer, a potem go autoryzuj:

codex mcp add kit --url https://startupkit.app/api/v1/mcp
codex mcp login kit

codex mcp add zapisuje tylko wpis w konfiguracji — dopiero codex mcp login otwiera przeglądarkę z ekranem zgody. Codex obsługuje Streamable HTTP bezpośrednio, więc proxy mcp-remote nie jest potrzebne.

Równoważny wpis w ~/.codex/config.toml:

[mcp_servers.kit]
url = "https://startupkit.app/api/v1/mcp"

Jeśli edytujesz plik ręcznie, uruchom potem raz codex mcp login kit, żeby uzyskać token. codex mcp list pokazuje połączenie, a codex mcp logout kit usuwa dane logowania.

OpenCode

Dodaj serwer do opencode.json — albo globalnego w ~/.config/opencode/opencode.json, albo osobnego w katalogu głównym projektu:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kit": {
      "type": "remote",
      "url": "https://startupkit.app/api/v1/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

Następnie autoryzuj połączenie:

opencode mcp auth kit

opencode mcp list pokazuje status uwierzytelnienia każdego serwera, a opencode mcp logout kit usuwa zapisany token. "oauth": {} oznacza, że ten serwer uwierzytelnia się przez OAuth; "oauth": false jest dla serwerów, które zamiast tego oczekują stałego klucza API w headers — Kit do nich nie należy.

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)
Training	training_read	training_write	Programy szkoleniowe, slajdy, quizy, poświadczenia, status ukończenia oraz zaproszenia uczestników
Performance	performance_read	performance_write	Cykle ocen, uczestnicy, własne oceny oraz rejestr ocen na potrzeby SOC 2
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, narzędzie do oczyszczania plików PDF, badanie adresów IP oraz weryfikację adresów e-mail.

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. Moduły, które konto ma, ale Ty ich nie masz, pokazują się wyszarzone i opisane jako Poza Twoją rolą — widzisz, że istnieją, ale nie możesz ich przyznać. Nawet gdyby mimo to zostały wysłane, Kit odrzuca je po stronie serwera, więc połączenie nigdy nie utrzyma zakresu, do którego jego właściciel nie ma dostępu. Żeby taki moduł dostać, poproś o niego administratora; w wierszu jest link do prośby.

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 zostały odłączone. Połącz je ponownie i na ekranie zgody wybierz moduły, do których chcesz przyznać dostęp.

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