> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Połącz Craft z Asystentami AI i narzędziami developerskimi za pomocą Model Context Protocol.

Craft obsługuje MCP (Model Context Protocol), które pozwala bezpiecznie łączyć twoje Dokumenty w Craft z zewnętrznymi narzędziami. Dzięki temu kompatybilne aplikacje – w tym Asystenci AI i narzędzia dla deweloperów – mogą odczytywać i przetwarzać wybraną przez ciebie zawartość.

## Czym jest MCP?

MCP (Model Context Protocol) to standard, który umożliwia zewnętrznym aplikacjom dostęp do określonego źródła informacji. W Craft MCP daje tym narzędziom kontrolowany dostęp do wybranych treści, aby mogły je bezpiecznie odczytywać, przetwarzać i wykorzystywać.

Po włączeniu MCP zewnętrzne narzędzia mogą:

* Odczytywać zawartość twoich Dokumentów w Craft
* Generować podsumowania, wnioski lub transformacje
* Pomagać w pisaniu lub restrukturyzacji treści
* Wykorzystywać twoje Dokumenty jako źródło wiedzy na żywo
* Przeszukiwać wybrane Dokumenty

Dzięki temu nie musisz ręcznie eksportować ani kopiować i wklejać treści.

## Jak działa MCP w Craft

Utwórz **MCP Connection** z zakładki **Imagine tab** na sidebarze, aby udostępnić odpowiednie części swojej przestrzeni roboczej zewnętrznym narzędziom.

Możesz wybrać jedną z opcji:

* Utworzenie połączenia MCP, które obejmuje **wszystkie twoje Dzienne Notatki**, lub
* Skonfigurowanie **połączenia niestandardowego**, w którym wybierasz konkretne Dokumenty (jeden lub więcej) do udostępnienia

Każde połączenie pozwala zdefiniować uprawnienia dostępu i widoczność, dzięki czemu masz kontrolę nad tym, co jest udostępniane. Po utworzeniu Craft automatycznie generuje **unikalny MCP endpoint** dla tego połączenia. Następnie możesz dodać ten endpoint do dowolnego narzędzia zgodnego z MCP, aby bezpiecznie połączyć je z wybranymi Dokumentami – reszta twojej przestrzeni pozostaje prywatna.

<Info title="Pełny dostęp do API Przestrzeni (v3.3.5+)">
  Serwer MCP w Craft obsługuje teraz **pełny dostęp na poziomie Przestrzeni** z zaawansowanymi możliwościami:

  * **Wyszukiwanie we wszystkich Dokumentach** z filtrowaniem po Folderach, Tagach i dacie
  * **Dzienne Notatki i Zadania** są w pełni dostępne przez MCP
  * **Tworzenie, aktualizacja i usuwanie** Dokumentów programowo
  * **Zarządzanie Kolekcjami**, w tym tworzenie i edycja schematów
  * **Zaawansowane wyszukiwanie** z obsługą regex i filtrami dat uwzględniającymi strefę czasową
  * **Organizacja oparta na Folderach** z obsługą rekursywnych podfolderów

  Zobacz [oficjalną dokumentację MCP](https://www.craft.do/imagine/) po więcej informacji.
</Info>

Po utworzeniu połączenia MCP w Craft skopiuj wygenerowany link MCP lub poświadczenia z zakładki Imagine. Kolejne kroki odbywają się poza Craft.

Otwórz narzędzie zgodne z MCP, którego chcesz użyć (na przykład Asystenta AI lub środowisko developerskie), znajdź opcję dodania serwera MCP lub konektora i wklej skopiowane dane. Od tego momentu narzędzie będzie miało dostęp tylko do notatek lub Dokumentów uwzględnionych w tym połączeniu, zgodnie z ustawionymi uprawnieniami.

## Obsługiwane połączenia MCP

Craft obecnie obsługuje integracje MCP z:

* **Claude** (Desktop i Claude Code)
* **ChatGPT**
* **Windsurf**
* **Cursor**
* **Visual Studio Code**
* **Raycast**
* **Inne standardowe klienty MCP**

Te narzędzia mogą łączyć się bezpośrednio z twoimi Dokumentami w Craft, aby je odczytywać i pomagać w pracy z ich zawartością.

## Co możesz robić dzięki MCP

Po włączeniu MCP możesz:

* Prosić Asystentów AI o analizę lub podsumowanie twoich Dokumentów
* Generować lub przepisywać treści na podstawie Dokumentów w Craft
* Wykorzystywać narzędzia developerskie do tworzenia niestandardowych workflowów lub skryptów z użyciem zawartości Craft
* Interagować z Dokumentami z poziomu środowisk programistycznych, takich jak Visual Studio Code, Cursor czy Windsurf
* Programowo wyszukiwać i filtrować Dokumenty
* Rozszerzać Craft za pomocą własnych narzędzi lub automatyzacji zgodnych z MCP

MCP pozwala płynnie łączyć Craft z twoimi ulubionymi narzędziami AI i developerskimi.

## Pełne przewodniki i dokumentacja

Wszystkie instrukcje konfiguracji i przewodniki integracyjne są dostępne pod adresem:

👉 [**https://www.craft.do/imagine/**](https://www.craft.do/imagine/)

Znajdziesz tam dedykowane przewodniki dla Claude, ChatGPT i innych obsługiwanych narzędzi MCP.

## Rozwiązywanie problemów

Jeśli masz problemy z połączeniem między Craft a klientem MCP (szczególnie w przypadku narzędzi takich jak Claude, które są często aktualizowane), poniższe kroki zazwyczaj rozwiązują problem:

<Steps>
  <Step title="Połącz ponownie">
    Spróbuj rozłączyć i ponownie połączyć serwer MCP w aplikacji klienckiej.
  </Step>

  <Step title="Odtwórz konektor">
    Jeśli ponowne połączenie nie pomogło, usuń konektor MCP z aplikacji klienckiej i skonfiguruj go ponownie, używając tego samego łącza.
  </Step>

  <Step title="Odtwórz łącze w Craft">
    Jeśli problem nadal występuje, usuń połączenie MCP w zakładce Imagine w Craft i utwórz nowe. Następnie dodaj nowe łącze do aplikacji klienckiej.
  </Step>
</Steps>

<Info>
  Niektórzy klienci MCP wydają aktualizacje bardzo często, co czasami może przerywać istniejące połączenia. Powyższe kroki rozwiązują większość problemów, choć w rzadkich przypadkach może być konieczne poczekanie na poprawkę od twórców aplikacji klienckiej.
</Info>

<CardGroup cols={2}>
  <Card title="Bezpieczeństwo MCP" href="/pl/integrate/mcp/security">
    Dowiedz się o funkcjach zabezpieczeń MCP i kontrolach dostępu
  </Card>

  <Card title="Ograniczenia ChatGPT" href="/pl/integrate/mcp/chatgpt-limitations">
    Zrozum obecne ograniczenia przy użyciu MCP z ChatGPT
  </Card>
</CardGroup>