confluence-v2

Full Confluence Cloud REST API v2 skill (pages, spaces, folders, databases, whiteboards, comments, labels, tasks, properties, etc.) with basic/OAuth auth, pagination, and migration from confluence-cli.

1. Przygotuj dane dostępowe do Confluence Cloud. Potrzebujesz adresu URL instancji (np. https://twoja-domena.atlassian.net/wiki), adresu email oraz tokenu API (lub tokenu OAuth). Token API możesz wygenerować w ustawieniach konta Atlassian.

2. Skonfiguruj zmienne środowiskowe lub plik konfiguracyjny. Ustaw CONFLUENCE_BASE_URL, CONFLUENCE_AUTH_METHOD (basic lub oauth), CONFLUENCE_EMAIL i CONFLUENCE_API_TOKEN (lub CONFLUENCE_OAUTH_TOKEN dla OAuth). Jeśli migrujesz z confluence-cli, umiejętność automatycznie mapuje konfigurację z ~/.confluence-cli/config.json.

3. Zainstaluj umiejętność w swoim agencie AI lub środowisku MCP. Umiejętność zawiera skrypty Node.js w katalogu scripts/, które działają jako wrappers dla API.

4. Wykonaj pierwsze zapytanie, aby wyświetlić listę przestrzeni lub stron. Uruchom node scripts/spaces.js list --all lub node scripts/pages.js list --all, aby pobrać wszystkie zasoby. Możesz też pobrać pojedynczy element, np. node scripts/pages.js get 89522178.

5. Używaj ad-hoc zapytań do endpointów API, jeśli potrzebujesz bardziej zaawansowanych operacji. Skrypt scripts/call.js pozwala na bezpośrednie wywoływanie dowolnego endpointu, np. node scripts/call.js GET /folders/87457793/direct-children.

6. Integruj umiejętność z agentami AI, aby automatyzować operacje na dokumentach — tworzenie stron, zarządzanie etykietami, dodawanie komentarzy czy aktualizowanie właściwości. Wszystkie grupy endpointów v2 (pages, spaces, folders, databases, whiteboards, comments, labels, tasks, properties) są w pełni obsługiwane.