Serwer MCP

clarife udostępnia serwer MCP (Model Context Protocol), który pozwala agentom AI - takim jak Claude, Cursor czy inne kompatybilne narzędzia - bezpośrednio operować na Twoich dokumentach, projektach i udostępnieniach.

Endpoint MCP

https://my.clarife.app/api/v1/mcp

Transport: Streamable HTTP (standard MCP SDK)

Konfiguracja Claude Desktop

Dodaj do pliku claude_desktop_config.json:

json

{
  "mcpServers": {
    "clarife": {
      "url": "https://my.clarife.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer clrf_xxxxx"
      }
    }
  }
}

Aby operować w kontekście workspace, dodaj nagłówek X-Workspace-Id:

json

{
  "mcpServers": {
    "clarife": {
      "url": "https://my.clarife.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer clrf_xxxxx",
        "X-Workspace-Id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  }
}

Konfiguracja Cursor

W ustawieniach Cursor przejdź do MCP Servers i dodaj:

json

{
  "mcpServers": {
    "clarife": {
      "url": "https://my.clarife.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer clrf_xxxxx"
      }
    }
  }
}

Konfiguracja Claude Code

Uruchom w terminalu:

bash

claude mcp add clarife \
  --transport http \
  https://my.clarife.app/api/v1/mcp \
  --header "Authorization: Bearer clrf_xxxxx"

Alternatywnie dodaj do pliku .claude/settings.json w swoim projekcie:

json

{
  "mcpServers": {
    "clarife": {
      "url": "https://my.clarife.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer clrf_xxxxx"
      }
    }
  }
}

Dostępne narzędzia (36)

Serwer MCP rejestruje narzędzia pogrupowane według zasobów. Każde narzędzie wymaga odpowiedniego scope na kluczu API.

Profil

Narzędzie	Opis	Scope
get_me	Profil użytkownika, plan, zużycie i limity	-

Dokumenty

Narzędzie	Opis	Scope
list_documents	Lista dokumentów z paginacją i filtrowaniem	documents:read
get_document	Pobierz dokument z pełną treścią i numerem wersji	documents:read
create_document	Utwórz nowy dokument	documents:write
update_document	Zaktualizuj tytuł, opis lub treść (opcjonalny expected_version)	documents:write
delete_document	Usuń dokument (soft delete, 30 dni w koszu)	documents:write

💡 Wskazówka: update_document przyjmuje opcjonalne pole expected_version - wartość version z odpowiedzi get_document. Jeśli dokument został w międzyczasie zmieniony (edytor, inna karta, inna integracja), zapis zakończy się błędem CONFLICT zamiast cichego nadpisania - wtedy odczytaj dokument ponownie, nanieś zmiany na świeżą treść i ponów zapis. Szczegóły: API Dokumentów.

Projekty

Narzędzie	Opis	Scope
list_projects	Lista projektów	projects:read
get_project	Szczegóły projektu z liczbą dokumentów	projects:read
create_project	Utwórz projekt	projects:write
update_project	Zaktualizuj projekt	projects:write
delete_project	Usuń projekt (trwale)	projects:write
move_project	Przenieś projekt do innego folderu	projects:write

Foldery

Narzędzie	Opis	Scope
list_folders	Lista folderów (filtruj po entity_type)	projects:read
get_folder	Szczegóły folderu	projects:read
create_folder	Utwórz folder (max 3 poziomy)	projects:write
update_folder	Zaktualizuj folder	projects:write
delete_folder	Usuń folder (kaskadowo)	projects:write

Udostępnienia

Narzędzie	Opis	Scope
list_shares	Lista linków udostępniania	shares:read
get_share	Szczegóły udostępnienia	shares:read
create_share	Utwórz link udostępniania	shares:write
update_share	Zaktualizuj ustawienia udostępnienia	shares:write
delete_share	Usuń link udostępniania	shares:write

Media

Narzędzie	Opis	Scope
create_media_upload	Uzyskaj presigned URL do uploadu	media:write
confirm_media_upload	Potwierdź upload pliku	media:write

Workspace

Narzędzie	Opis	Scope
get_workspace_info	Informacje o workspace	workspace:read
list_workspace_members	Lista członków zespołu	workspace:read

Brandingi

Narzędzie	Opis	Scope
list_brandings	Lista brandingów (plan Business)	brandings:read

Baza Wiedzy

Narzędzia Bazy Wiedzy wymagają planu Business - na planie Pro zwracają błąd PLAN_LIMIT_REACHED.

Narzędzie	Opis	Scope
list_knowledge_bases	Lista Twoich baz	kb:read
get_knowledge_base	Baza z kategoriami i wpisami	kb:read
update_knowledge_base	Zmiana ustawień bazy	kb:write
create_kb_category	Utworzenie kategorii (drzewo do 3 poziomów)	kb:write
update_kb_category	Edycja kategorii	kb:write
delete_kb_category	Usunięcie kategorii	kb:write
create_kb_entry	Dodanie wpisu z linku udostępniania	kb:write
update_kb_entry	Edycja wpisu	kb:write
delete_kb_entry	Usunięcie wpisu	kb:write

Zasoby (Resources)

Serwer MCP udostępnia zasoby dokumentacyjne, które klienci AI mogą odczytać, aby zrozumieć format dokumentów i workflow:

URI zasobu	Opis
clarife://guides/content-format	Kompletny przewodnik po typach bloków, wymaganych polach i workflow uploadu obrazów
clarife://guides/knowledge-base	Workflow publikacji do Bazy Wiedzy (dokument → link → wpis), kategorie i limity

💡 Wskazówka: Klienci AI mogą odczytać clarife://guides/content-format aby poznać dokładny schemat bloków przed tworzeniem lub aktualizacją dokumentów. Zasób dokumentuje wszystkie typy bloków (heading, text, screenshot, image, divider, code, table) z wymaganymi polami i przykładami.

Przykładowe polecenia

Po podłączeniu serwera MCP możesz poprosić agenta AI np.:

"Pokaż moje ostatnie dokumenty"
"Utwórz nowy dokument z instrukcją krok po kroku"
"Prześlij ten screenshot i dodaj go do poradnika"
"Udostępnij tutorial z hasłem"
"Pokaż członków mojego workspace"
"Opublikuj ten poradnik w mojej Bazie Wiedzy, w kategorii Pierwsze kroki"

💡 Wskazówka: Nadaj kluczowi API dla MCP tylko te scopy, których agent potrzebuje. Dla eksploracji read-only wystarczą documents:read i projects:read.