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
Konfiguracja Claude Desktop
Dodaj do pliku claude_desktop_config.json:
{
"mcpServers": {
"clarife": {
"url": "https://my.clarife.app/api/v1/mcp",
"headers": {
"Authorization": "Bearer clrf_xxxxx"
}
}
}
}
X-Workspace-Id:
{
"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:
{
"mcpServers": {
"clarife": {
"url": "https://my.clarife.app/api/v1/mcp",
"headers": {
"Authorization": "Bearer clrf_xxxxx"
}
}
}
}
Konfiguracja Claude Code
Uruchom w terminalu:
claude mcp add clarife \
--transport http \
https://my.clarife.app/api/v1/mcp \
--header "Authorization: Bearer clrf_xxxxx"
.claude/settings.json w swoim projekcie:
{
"mcpServers": {
"clarife": {
"url": "https://my.clarife.app/api/v1/mcp",
"headers": {
"Authorization": "Bearer clrf_xxxxx"
}
}
}
}
Dostępne narzędzia (28)
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ą | documents:read |
create_document | Utwórz nowy dokument | documents:write |
update_document | Zaktualizuj tytuł, opis lub treść | documents:write |
delete_document | Usuń dokument (soft delete, 30 dni w koszu) | documents:write |
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 |
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 |
| 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 |
Po podłączeniu serwera MCP możesz poprosić agenta AI np. “Pokaż moje ostatnie dokumenty” albo “Utwórz nowy projekt o nazwie Onboarding”. Agent automatycznie wybierze odpowiednie narzędzie.
