Połącz Picasi z Claude Code

O co chodzi

Konfigurujesz Picasi jako serwer MCP w Claude Code. Następnie możesz bezpośrednio na czacie Claude pytać o aktualizacje konkurentów, zarządzać źródłami lub wyświetlać raporty — bez otwierania aplikacji Picasi.

Czego potrzebujesz

Token API Picasi (instrukcja: Utwórz token API)
Adres URL MCP waszego obszaru roboczego (znajduje się w sekcji Ustawienia → Połączenia AI i tokeny)

Opcja A: Konfiguracja za pomocą CLI

Przygotuj token i adres URL

Otwórz Ustawienia → Połączenia AI i tokeny w Picasi i skopiuj adres URL MCP (format: https://picasi.app/mcp/t-xxxxxxxxxx).

Dodaj serwer MCP

W terminalu wpisz następujące polecenie:

claude mcp add picasi \
  --transport http \
  --url https://picasi.app/mcp/t-xxxxxxxxxx \
  --header "Authorization: Bearer DEIN_TOKEN"

Zastąp t-xxxxxxxxxx i DEIN_TOKEN swoimi rzeczywistymi wartościami.

Sprawdź połączenie

Uruchom Claude Code i wpisz:

Jakie źródła znajdują się w moim obszarze roboczym Picasi?

Jeśli połączenie działa, Claude odpowie prawdziwymi danymi.

Opcja B: Edytuj bezpośrednio plik `.mcp.json`

Jeśli wolisz przechowywać konfigurację jako plik w projekcie:

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-xxxxxxxxxx",
      "headers": {
        "Authorization": "Bearer DEIN_TOKEN"
      }
    }
  }
}

Umieść ten plik jako .mcp.json w katalogu głównym projektu. Claude Code odczyta go automatycznie.

Zmienne środowiskowe zamiast tekstu jawnego

W przypadku projektów, których plik .mcp.json znajduje się w Git, nigdy nie wpisuj tokenu w postaci tekstu jawnego. Dwa bezpieczne sposoby:

1. Globalna konfiguracja Claude Code

Zamiast tworzyć .mcp.json specyficzny dla projektu, skonfiguruj serwer globalnie:

claude mcp add picasi \
  --scope user \
  --transport http \
  --url https://picasi.app/mcp/t-xxxxxxxxxx \
  --header "Authorization: Bearer DEIN_TOKEN"

Serwer będzie wtedy dostępny we wszystkich projektach bez konieczności umieszczania .mcp.json w repozytorium.

2. Zmienna środowiskowa w pliku, który nie jest zatwierdzany

W przypadku serwerów specyficznych dla projektu: zatwierdź .mcp.json do repozytorium, ale odczytaj token ze środowiska.

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-xxxxxxxxxx",
      "headers": {
        "Authorization": "Bearer ${env:PICASI_API_TOKEN}"
      }
    }
  }
}

Zmienną PICASI_API_TOKEN należy ustawić w pliku .env (w .gitignore) lub bezpośrednio w powłoce, w której uruchamia się Claude Code:

export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude Code odczytuje tę zmienną dopiero podczas uruchamiania. W przypadku zmiany tokenu należy ponownie uruchomić Claude Code.

Wiele obszarów roboczych

W przypadku wielu obszarów roboczych Picasi (np. agencja obsługująca wielu klientów) należy utworzyć osobny wpis serwera dla każdego obszaru roboczego i nadać mu jednoznaczną nazwę:

{
  "mcpServers": {
    "picasi-kunde-a": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-aaaaaaa",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_A}" }
    },
    "picasi-kunde-b": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-bbbbbbb",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_B}" }
    }
  }
}

Claude Code uruchamia narzędzia serwerów w oddzielnych przestrzeniach nazw (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), dzięki czemu nie dochodzi do pomyłek.

Tematy powiązane

Narzędzia MCP — przegląd Wszystkie dostępne narzędzia MCP wraz z parametrami.