Połącz aplikacje AI (MCP)

Kimiko ma wbudowany serwer MCP, dzięki któremu aplikacje AI na Twoim komputerze mogą przeszukiwać spotkania, odczytywać notatki i transkrypcje oraz pracować z zadaniami. MCP (Model Context Protocol) to otwarty standard, przez który aplikacje AI łączą się z narzędziami.

Serwer kimiko-mcp jest częścią Kimiko i działa na Twoim komputerze. Aplikacja AI uruchamia go, gdy go potrzebuje, a serwer kończy działanie, gdy aplikacja zamyka połączenie. Serwer nie ma wersji online, więc mogą się z nim połączyć tylko aplikacje na tym samym komputerze.

Co może aplikacja AI

Połączona aplikacja dostaje dziesięć narzędzi. Osiem z nich odczytuje bibliotekę, a dwa zmieniają zadania.

Narzędzie	Do czego służy
list_meetings	Wyświetla spotkania i notatki od najnowszych, według daty, projektu lub typu
search_meetings	Przeszukuje transkrypcje, notatki, podsumowania i tytuły oraz zwraca fragmenty ze znacznikami czasu
get_meeting	Pokazuje szczegóły spotkania, zaproszone osoby i mówców oraz najnowsze podsumowanie
get_notes	Odczytuje Twoje notatki, ich dopracowaną wersję, jeśli istnieje, i podsumowania na żywo
get_transcript	Odczytuje transkrypcję strona po stronie, aby długie spotkanie nie zalało aplikacji tekstem
get_screenshots	Odczytuje tekst rozpoznany przez Kimiko na zrzutach ekranu z rozmowy, nigdy same obrazy
list_tasks	Wyświetla zadania wraz z ich spotkaniem i projektem; zadania ukończone tylko wtedy, gdy aplikacja o nie poprosi
list_projects	Wyświetla projekty z liczbą zadań
create_task	Dodaje zadanie
update_task	Edytuje zadanie, przenosi je do innego statusu lub projektu albo oznacza jako ukończone

Wyszukiwanie zawsze dopasowuje słowa kluczowe. Jeśli model wyszukiwania działa w Ollama lub na innym serwerze lokalnym na Twoim komputerze, wyszukiwanie dopasowuje też znaczenie. Przy wbudowanej konfiguracji aplikacje AI wyszukują według słów kluczowych. Zobacz wyszukiwanie w czacie.

Gotowe prompty

Kimiko oferuje też trzy prompty. Aplikacje obsługujące prompty MCP pokazują je jako polecenia z ukośnikiem albo w menu promptów.

• weekly_review: przegląd minionego tygodnia albo dłuższego okresu, do 90 dni, z decyzjami, zobowiązaniami, otwartymi sprawami i otwartymi zadaniami według projektów. Argument days określa okres: od 1 do 90 dni (domyślnie 7).
• meeting_prep: notatka przygotowawcza o osobie lub temacie z kontekstem, zobowiązaniami obu stron, otwartymi sprawami i pytaniami do poruszenia. Argument person_or_topic jest wymagany.
• open_loops: zaległe zadania oraz zobowiązania z ostatnich dwóch tygodni, które nie stały się zadaniem. Opcjonalny argument project, czyli nazwa lub identyfikator projektu, zawęża wynik do jednego projektu. Prompt prosi aplikację o utworzenie zadania dopiero po Twoim potwierdzeniu.

W Claude Code wpisz / i wybierz Kimiko:meeting_prep (MCP) albo wpisz /mcp__Kimiko__meeting_prep Anna. Claude Code dzieli argumenty w miejscach spacji, więc podaj tam osobę lub temat jednym słowem.

Czego aplikacja nigdy nie może zrobić

Kimiko nie pozwala aplikacjom AI:

• rozpoczynać ani zatrzymywać nagrywania
• usuwać zadań, spotkań ani notatek
• tworzyć ani usuwać projektów
• zmieniać notatek
• otwierać nagrań dźwiękowych ani obrazów zrzutów ekranu
• odczytywać ustawień ani kluczy API

Gdy opcja Zezwalaj na zmiany zadań jest włączona, aplikacja może jednak edytować zadanie, w tym wyczyścić jego szczegóły, przypisanie lub daty.

Włącz dostęp

Dostęp jest wyłączony, dopóki go nie włączysz.

1. Otwórz Ustawienia → Połączenia.
2. Na karcie Serwer MCP włącz opcję Zezwalaj aplikacjom AI na dostęp.

Gdy ta opcja jest włączona, każda aplikacja na Twoim komputerze, która uruchomi serwer MCP Kimiko, może odczytywać spotkania. Każda akcja dodawania i kopiowania w sekcji Ustawienia → Połączenia sama włącza dostęp, a Kimiko o tym informuje.

Opcja Zezwalaj na zmiany zadań na karcie Co mogą aplikacje jest domyślnie włączona. Pozwala aplikacjom tworzyć i aktualizować zadania. Po jej wyłączeniu aplikacje mogą odczytywać zadania, ale nie mogą ich zmieniać. Kimiko od razu odrzuca create_task i update_task i pomija je na liście narzędzi, którą aplikacja wczyta po tej zmianie.

Wyłączenie lub włączenie opcji Zezwalaj aplikacjom AI na dostęp działa od następnego zapytania połączonej aplikacji. Jeśli aplikacja próbowała uruchomić Kimiko, gdy dostęp był wyłączony, uruchom ją ponownie. Zmiana opcji Zezwalaj na zmiany zadań też obowiązuje od następnego zapytania, ale aplikacja zachowuje listę narzędzi wczytaną przy połączeniu, dopóki nie uruchomisz jej ponownie lub nie połączysz jej od nowa.

Połącz aplikację

Na Macu pozwól serwerowi Kimiko korzystać z pęku kluczy, zanim aplikacja połączy się po raz pierwszy, aby jednorazowe pytanie macOS nie schowało się za aplikacją. W wierszu Dostęp do pęku kluczy wybierz Autoryzuj teraz, a potem Zawsze pozwalaj. Gdy dostęp jest włączony, ten wiersz znajduje się na karcie Serwer MCP, a w przeciwnym razie na karcie Pomoc. Więcej wyjaśnia część Pytanie macOS o dostęp do pęku kluczy.

Karta Aplikacje AI w sekcji Ustawienia → Połączenia łączy za Ciebie te aplikacje:

• Claude (aplikacja na komputer): wybierz Dodaj do Claude. Kimiko pokazuje, co zapisze w pliku ustawień Claude, najpierw tworzy kopię zapasową i zachowuje pozostałe ustawienia. Wybierz Dodaj, a potem całkowicie zamknij Claude i otwórz go ponownie, bo Claude odczytuje ustawienia tylko przy uruchomieniu. Na Macu wybierz Claude → Quit Claude; w systemie Windows kliknij prawym przyciskiem myszy ikonę Claude w zasobniku systemowym i wybierz Quit. Samo zamknięcie okna nie wystarczy.
• Claude Code: wybierz Dodaj do Claude Code, aby dodać Kimiko do wszystkich projektów, a potem rozpocznij nową sesję Claude Code. Jeśli Kimiko nie znajdzie polecenia claude, w wierszu pojawi się zamiast tego przycisk Kopiuj polecenie. Uruchom to polecenie w Terminalu na Macu lub w terminalu w systemie Windows.
• Cursor: wybierz Dodaj do Cursor. Cursor otworzy własne okno instalacji z wypełnionymi danymi Kimiko; potwierdź tam instalację.
• VS Code: wybierz Dodaj do VS Code, aby otworzyć w VS Code stronę instalacji Kimiko, a potem potwierdź instalację. Narzędzia Kimiko działają w trybie agenta GitHub Copilot.
• LM Studio (wersja 0.3.17 lub nowsza): otwórz Więcej aplikacji i wybierz Dodaj do LM Studio. LM Studio otworzy własne okno z wypełnionymi danymi Kimiko; potwierdź je tam.

Pozostałe aplikacje na liście Więcej aplikacji mają przycisk Kopiuj polecenie, Kopiuj konfigurację lub Kopiuj ścieżkę: ChatGPT i Codex, Gemini CLI, Raycast, Zed, Windsurf oraz Warp. Każdy z nich kopiuje gotowy fragment z dokładną ścieżką dla Twojego komputera.

Dodaj Kimiko ręcznie

Każda z poniższych aplikacji uruchamia ten sam serwer o nazwie Kimiko, bez argumentów i zmiennych środowiskowych.

Niezależnie od aplikacji najpierw włącz opcję Zezwalaj aplikacjom AI na dostęp. Każda akcja kopiowania w sekcji Ustawienia → Połączenia robi to za Ciebie. Na Macu, zanim aplikacja połączy się po raz pierwszy, wybierz też Autoryzuj teraz w wierszu Dostęp do pęku kluczy, a potem Zawsze pozwalaj.

Przykłady używają ścieżki serwera na Macu, gdy Kimiko znajduje się w folderze Aplikacje:

/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp

Jeśli Kimiko jest w innym miejscu, użyj zamiast tego fragmentu z sekcji Ustawienia → Połączenia. Zawsze zawiera on właściwą ścieżkę do uruchomionej kopii Kimiko. Aby skopiować samą ścieżkę, otwórz Więcej aplikacji i wybierz Kopiuj ścieżkę w wierszu Raycast.

W systemie Windows Dodaj do Claude i Dodaj do Cursor wpisują ścieżkę za Ciebie. Aby skonfigurować którąś z tych aplikacji ręcznie, użyj przycisku Kopiuj konfigurację w wierszu Windsurf lub Warp na liście Więcej aplikacji: kopiuje on ten sam wpis mcpServers ze ścieżką, w której ukośniki odwrotne są już podwojone. Zed ma własny przycisk Kopiuj konfigurację; wiersz ChatGPT i Codex też, w swoim menu ⋯. Jeśli samodzielnie wpisujesz ścieżkę Windows do pliku JSON lub TOML, podwój każdy ukośnik odwrotny (C:\\Users\\…\\kimiko-mcp.exe). W systemie Windows ~ w poniższych ścieżkach oznacza folder użytkownika (%USERPROFILE%).

Claude (aplikacja na komputer)

Dodaj ten wpis do pliku ustawień Claude, czyli ~/Library/Application Support/Claude/claude_desktop_config.json na Macu lub %APPDATA%\Claude\claude_desktop_config.json w systemie Windows, i zachowaj pozostałe serwery. Na Macu wpis wygląda tak:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

W systemie Windows serwer to plik kimiko-mcp.exe obok kimiko-app.exe; jego dokładną ścieżkę skopiuj z sekcji Ustawienia → Połączenia.

Następnie całkowicie zamknij Claude i otwórz go ponownie: na Macu wybierz Claude → Quit Claude, a w systemie Windows kliknij prawym przyciskiem myszy ikonę Claude w zasobniku systemowym i wybierz Quit. Samo zamknięcie okna nie wystarczy. Narzędzia i prompty Kimiko pojawią się wtedy w Claude.

Claude Code

Na Macu uruchom w terminalu:

claude mcp add --scope user --transport stdio Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Opcja --scope user dodaje Kimiko do każdego projektu. Użyj --scope project, aby zamiast tego dodać serwer do pliku .mcp.json bieżącego projektu. Polecenie claude mcp list pokazuje, czy serwer się połączył, a /mcp w sesji wyświetla listę narzędzi.

Cursor

Na Macu dodaj do pliku ~/.cursor/mcp.json ten sam wpis mcpServers co w przypadku Claude:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

VS Code

Dodaj Kimiko do swojego pliku mcp.json użytkownika (~/Library/Application Support/Code/User/mcp.json lub %APPDATA%\Code\User\mcp.json w systemie Windows). Na Macu wpis wygląda tak:

{
  "servers": {
    "Kimiko": {
      "type": "stdio",
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Na Macu możesz też dodać go z terminala:

code --add-mcp '{"name":"Kimiko","command":"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp","args":[]}'

ChatGPT i Codex

Wątki Codex w aplikacji ChatGPT na komputer i Codex CLI korzystają ze wspólnego pliku ~/.codex/config.toml. Kimiko działa w Codex, a nie w zwykłych czatach ChatGPT. Na Macu wpis wygląda tak:

[mcp_servers.Kimiko]
command = "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Na Macu możesz też uruchomić:

codex mcp add Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Gemini CLI

Na Macu to polecenie dodaje Kimiko do pliku ~/.gemini/settings.json:

gemini mcp add -s user Kimiko "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Zed

Dodaj wpis context_servers do pliku ustawień Zed (~/.config/zed/settings.json na Macu, %APPDATA%\Zed\settings.json w systemie Windows). Na Macu wpis wygląda tak:

{
  "context_servers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp",
      "args": []
    }
  }
}

Raycast

W Raycast uruchom Install MCP Server, wybierz transport Standard Input/Output (stdio) i wklej ścieżkę serwera jako polecenie. Skopiujesz ją przyciskiem Więcej aplikacji → Raycast → Kopiuj ścieżkę.

Windsurf i Warp

Obie aplikacje przyjmują ten sam wpis mcpServers co Claude. W Windsurf dodaj go do pliku ~/.codeium/windsurf/mcp_config.json. W Warp otwórz ustawienia, potem AI, a następnie MCP servers i dodaj tam ten wpis. Przycisk Kopiuj konfigurację w wierszu każdej z tych aplikacji kopiuje ten wpis. Na Macu wygląda on tak:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Dowolna inna aplikacja

Dodaj lokalny serwer MCP o nazwie Kimiko, który korzysta z transportu stdio, a jego poleceniem jest ścieżka serwera, bez argumentów. Włącz opcję Zezwalaj aplikacjom AI na dostęp, a na Macu zezwól na dostęp do pęku kluczy, gdy aplikacja połączy się po raz pierwszy (zobacz niżej).

Aby przetestować serwer z terminala, uruchom go z opcją --check. Sprawdzenie otwiera bibliotekę, nie udostępniając niczego aplikacjom, a na Macu może wyświetlić pytanie o dostęp do pęku kluczy. Na Macu uruchom:

"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp" --check

W systemie Windows uruchom w PowerShell & "<path to kimiko-mcp.exe>" --check, podając ścieżkę z sekcji Ustawienia → Połączenia.

Gdy Kimiko może odczytać bibliotekę, sprawdzenie wypisuje ok. Nie sprawdza opcji Zezwalaj aplikacjom AI na dostęp, której aplikacje nadal potrzebują. Jeśli coś jest nie tak, wypisuje zamiast tego przyczynę, np. problem z pękiem kluczy lub bazą danych.

Aplikacje, które nie mogą się połączyć

Aplikacje AI działające w przeglądarce, takie jak claude.ai i ChatGPT w wersji internetowej, nie mogą się połączyć. Nie mogą tego zrobić także aplikacje mobilne. Łączą się one tylko z serwerami MCP w internecie, a serwer Kimiko celowo działa wyłącznie na Twoim komputerze.

W aplikacji ChatGPT na komputer Kimiko działa w wątkach Codex, a nie w zwykłych czatach.

Pytanie macOS o dostęp do pęku kluczy

Kimiko przechowuje klucz szyfrowania biblioteki w pęku kluczy macOS. Gdy kimiko-mcp po raz pierwszy go odczytuje, macOS pyta, czy może on używać Twojego pęku kluczy. Wybierz Zawsze pozwalaj.

To pytanie często otwiera się za oknem aplikacji AI, a pierwsze połączenie czeka, aż na nie odpowiesz. Aby tego uniknąć, wybierz Autoryzuj teraz w wierszu Dostęp do pęku kluczy w sekcji Ustawienia → Połączenia, zanim aplikacja połączy się po raz pierwszy. Pytanie otworzy się wtedy nad oknem Kimiko. Gdy dostęp jest włączony, ale jeszcze nieautoryzowany, wiersz znajduje się na karcie Serwer MCP; w przeciwnym razie na karcie Pomoc.

macOS może zapytać ponownie po aktualizacji Kimiko. Jeśli wybrano Zabroń, otwórz aplikację Dostęp do pęku kluczy, wyszukaj app.kimiko.db, usuń kimiko-mcp na karcie Kontrola dostępu, a potem wybierz Spróbuj ponownie w tym wierszu.

Menedżer poświadczeń w systemie Windows

W systemie Windows klucz jest zapisany w Menedżerze poświadczeń dla Twojego konta Windows, więc żadne pytanie się nie pojawia. Przycisk Sprawdź teraz w wierszu Menedżer poświadczeń na karcie Pomoc potwierdza, że aplikacje mogą go odczytać.

Prywatność

Sama aplikacja Kimiko niczego nie wysyła do internetu, gdy korzysta z niej aplikacja AI. Serwer odpowiada tylko aplikacji, która go uruchomiła, i nigdy nie łączy się z internetem. Wyszukiwanie korzysta z Twojego modelu wyszukiwania tylko wtedy, gdy działa on w Ollama lub na innym serwerze lokalnym na Twoim komputerze.

Dane odczytane przez aplikację przetwarza ta aplikacja i jej dostawca AI. Aplikacja korzystająca z AI w chmurze wysyła to, co odczyta, w tym tekst transkrypcji, do własnego dostawcy modelu, na warunkach tej aplikacji. Aplikacja korzystająca z modelu lokalnego może zatrzymać te dane na Twoim komputerze. Tryb tylko lokalny kontroluje połączenia samego Kimiko; nie powstrzymuje połączonej aplikacji przed wysłaniem tego, co odczyta.

Szczegóły spotkania mogą zawierać informacje z kalendarza, takie jak tytuł wydarzenia i zaproszone osoby wraz z ich imionami i nazwiskami oraz adresami e-mail. Aplikacja korzystająca z AI w chmurze wysyła je swojemu dostawcy tak samo jak wszystko inne, co odczyta.

Historia połączeń na karcie Pomoc pokazuje, które aplikacje korzystały z Kimiko i kiedy. Zapisuje tylko nazwy i wersje aplikacji, znaczniki czasu, liczniki i ostatnio użyte narzędzie, nigdy treść zapytań. Wpisy nieużywane od 90 dni są usuwane.

Co Kimiko przechowuje i wysyła, opisuje strona Prywatność i dane.

Treść spotkań nie jest zaufana

Każdy uczestnik spotkania może wypowiedzieć słowa skierowane do aplikacji AI, np. „zignoruj swoje instrukcje”, a udostępniony ekran może je wyświetlić. Podsumowania utworzone na podstawie spotkania mogą je powtórzyć, a mogą je zawierać także tytuły spotkań z zaproszeń w kalendarzu od innych osób. Kimiko informuje aplikację, że tekst transkrypcji, tekst z ekranu i podsumowania ma traktować jako dane, nigdy jako polecenia.

Mimo to sprawdzaj sugestie aplikacji, zanim na ich podstawie coś zrobisz. Jeśli aplikacja może uruchamiać narzędzia bez pytania, niech nadal pyta przed użyciem create_task i update_task: edycja może zmienić nazwę zadania, przenieść je albo wyczyścić jego szczegóły i daty. Kimiko nigdy nie pozwala aplikacji usunąć zadania. Jeśli aplikacje mają tylko odczytywać dane, wyłącz opcję Zezwalaj na zmiany zadań.

Wyłącz dostęp aplikacji AI

Wyłącz opcję Zezwalaj aplikacjom AI na dostęp w sekcji Ustawienia → Połączenia. Wszystkie aplikacje od razu tracą dostęp, a połączona aplikacja przy następnym zapytaniu otrzyma błąd agent access is off.

Aby usunąć Kimiko z aplikacji, usuń wpis Kimiko z jej ustawień. W przypadku Claude Code uruchom:

claude mcp remove Kimiko

Rozwiązywanie problemów

Najczęstsze z poniższych rozwiązań zawiera Pomoc → Brak połączenia? w sekcji Ustawienia → Połączenia.

Problem	Rozwiązanie
Aplikacja informuje, że nie udało się uruchomić Kimiko albo że połączenie zostało przerwane, lub zgłasza agent access is off	Włącz opcję Zezwalaj aplikacjom AI na dostęp, a potem uruchom aplikację ponownie. Jeśli przyczyną był wyłączony dostęp, dziennik aplikacji pokazuje agent access is off (ścieżkę dziennika Claude znajdziesz niżej; w przypadku Claude Code uruchom claude mcp get Kimiko).
Pierwsze połączenie na Macu się zawiesza	Pytanie o dostęp do pęku kluczy może kryć się za aplikacją. Wybierz Zawsze pozwalaj albo najpierw użyj opcji Autoryzuj teraz.
Claude Code rezygnuje po 30 sekundach	Uruchom go poleceniem MCP_TIMEOUT=60000 claude (w PowerShell: $env:MCP_TIMEOUT=60000; claude) albo najpierw użyj opcji Autoryzuj teraz. Polecenie claude mcp get Kimiko pokazuje komunikaty serwera.
Kimiko nie pojawia się w Claude	Całkowicie zamknij Claude i otwórz go ponownie; samo zamknięcie okna nie wystarczy. Dziennik Claude to ~/Library/Logs/Claude/mcp-server-Kimiko.log (w systemie Windows %APPDATA%\Claude\logs\mcp-server-Kimiko.log).
Tylko osiem narzędzi, bez create_task i update_task	Włącz opcję Zezwalaj na zmiany zadań, a potem uruchom aplikację ponownie (w Claude Code połącz ponownie Kimiko przez /mcp lub rozpocznij nową sesję).
Kimiko jest teraz w innym miejscu albo wiersz Claude pokazuje Wymaga aktualizacji	Wybierz Aktualizuj w wierszu Claude, a potem zamknij i ponownie otwórz Claude. W przypadku innych aplikacji dodaj Kimiko jeszcze raz albo ponownie skopiuj fragment z sekcji Ustawienia → Połączenia.
Kimiko informuje, że plik ustawień Claude jest nieprawidłowy	Popraw plik lub go usuń, a potem ponownie wybierz Dodaj do Claude. W pliku edytowanym ręcznie sprawdź, czy nie brakuje przecinka i czy ścieżka Windows nie zawiera pojedynczego ukośnika odwrotnego.
Sekcja Ustawienia → Połączenia informuje, że brakuje części Kimiko	Zainstaluj Kimiko ponownie.
Wyszukiwanie nic nie zwraca	Poproś o szerszy zakres dat, inny projekt lub typ albo poproś aplikację o przejrzenie spotkań za pomocą list_meetings.
Wyszukiwanie pomija spotkanie	Użyj słów, które padły na spotkaniu. Aplikacje wyszukują według słów kluczowych, chyba że model wyszukiwania działa na serwerze lokalnym.
Serwer od razu się zatrzymuje i informuje, że nie znaleziono bazy danych	Otwórz Kimiko raz, aby aplikacja mogła utworzyć bibliotekę.
Wiersz Dostęp do pęku kluczy pokazuje „Odmówiono”	Wykonaj kroki z części Pytanie macOS o dostęp do pęku kluczy.