# Połącz z Claude, Cursorem i innymi

> Jak dodać MCP ProseCaptain w Claude Code, Claude Desktop, Cursorze, VS Code, Windsurfie i Cline.

Najprościej przyciskami powyżej. Gdy prowadzą do logowania kontem ProseCaptain, wystarczy się zalogować, wybrać przestrzeń roboczą i zaakceptować zasady: token nie jest potrzebny. Do tego czasu (beta) **Połącz z VS Code** i **Połącz z Cursorem** proszą o token MCP. Tworzysz go w aplikacji ProseCaptain: **Ustawienia** → **Narzędzia AI** → **Nowy token**. Zaraz po utworzeniu tokenu aplikacja pokazuje te same przyciski już z Twoim tokenem.

Poniżej metoda z tokenem dla każdego narzędzia (sekcje **Zaawansowane**). Działa zawsze, także w narzędziach bez logowania OAuth.

## Claude Code

Skopiuj polecenie (powyżej w **Zaawansowane** albo tutaj), wstaw token w miejsce `pcm_TWOJ_TOKEN` i uruchom w terminalu. Sprawdź połączenie poleceniem `/mcp` w Claude Code. Na liście powinien być `prosecaptain-wp`.

<details>
<summary>Zaawansowane: polecenie</summary>

```bash
claude mcp add --transport http prosecaptain-wp https://wp-mcp.prosecaptain.com/mcp \
  --header "Authorization: Bearer pcm_TWOJ_TOKEN"
```

</details>

## Claude Desktop

Claude Desktop łączy się z serwerem z tokenem przez mały pomocnik `mcp-remote` (potrzebny Node.js). Jednym kliknięciem się nie da: konfigurację wklejasz raz, ręcznie.

<details>
<summary>Zaawansowane: plik konfiguracji</summary>

Otwórz **Settings** → **Developer** → **Edit Config** i dodaj:

```json
{
  "mcpServers": {
    "prosecaptain-wp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://wp-mcp.prosecaptain.com/mcp", "--header", "Authorization:${PC_AUTH}"],
      "env": { "PC_AUTH": "Bearer pcm_TWOJ_TOKEN" }
    }
  }
}
```

Zrestartuj Claude Desktop.

</details>

## Cursor

Kliknij **Połącz z Cursorem** powyżej. Cursor zapyta, czy zainstalować serwer. Potem w **Settings** → **MCP** wklej swój token w miejsce `pcm_TWOJ_TOKEN`. Przycisk w aplikacji, pokazany zaraz po utworzeniu tokenu, ma token już w środku.

<details>
<summary>Zaawansowane: ręczna konfiguracja</summary>

**Settings** → **MCP** → **Add new MCP server** albo plik `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "prosecaptain-wp": {
      "url": "https://wp-mcp.prosecaptain.com/mcp",
      "headers": { "Authorization": "Bearer pcm_TWOJ_TOKEN" }
    }
  }
}
```

</details>

## VS Code

Kliknij **Połącz z VS Code** powyżej. VS Code pokaże konfigurację serwera do sprawdzenia, a przy pierwszym użyciu zapyta o token i nie zapisze go w pliku.

<details>
<summary>Zaawansowane: plik .vscode/mcp.json</summary>

Plik `.vscode/mcp.json` w projekcie:

```json
{
  "inputs": [
    { "type": "promptString", "id": "prosecaptain-token", "description": "Token MCP ProseCaptain (pcm_…)", "password": true }
  ],
  "servers": {
    "prosecaptain-wp": {
      "type": "http",
      "url": "https://wp-mcp.prosecaptain.com/mcp",
      "headers": { "Authorization": "Bearer ${input:prosecaptain-token}" }
    }
  }
}
```

</details>

## Windsurf

Windsurf nie ma przycisku instalacji. Konfigurację wklejasz raz, ręcznie.

<details>
<summary>Zaawansowane: plik konfiguracji</summary>

Plik `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "prosecaptain-wp": {
      "serverUrl": "https://wp-mcp.prosecaptain.com/mcp",
      "headers": { "Authorization": "Bearer pcm_TWOJ_TOKEN" }
    }
  }
}
```

</details>

## Cline i inne klienty MCP

Skopiuj adres przyciskiem **Kopiuj adres** powyżej i dodaj serwer typu **Streamable HTTP**.

<details>
<summary>Zaawansowane: adres i nagłówek</summary>

```text
Adres:    https://wp-mcp.prosecaptain.com/mcp
Nagłówek: Authorization: Bearer pcm_TWOJ_TOKEN
```

</details>

## claude.ai i ChatGPT: wkrótce

Łączniki w claude.ai (Settings → Connectors) i w ChatGPT logują się przez OAuth, bez wklejania tokenu. Logowanie kontem ProseCaptain przez OAuth przygotowujemy. Do tego czasu używaj Claude Desktop albo Claude Code: to ten sam Claude.

## Pierwsze polecenie

Zacznij od listy stron:

```text
Pokaż moje strony w ProseCaptain i powiedz, co jest na stronie głównej squares.pl.
```

Narzędzie AI wywoła `list_sites` i `site_info`. Na produkcji przed każdą zmianą zapyta o potwierdzenie.

## Kiedy coś nie działa

| Objaw | Co zrobić |
|---|---|
| `401 invalid_token` | Token odebrany albo wklejony z błędem. Wydaj nowy w aplikacji. |
| Brak strony na liście | Strona nie jest połączona z tym workspace'em. Kliknij **Connect to AI** we wtyczce. |
| „lacks the permission” przy menu albo widżetach | Użytkownik ma rolę Redaktor. Zmień ją na ProseCaptain AI albo połącz stronę jeszcze raz z wtyczki. |
| `wordpress_error` przy łączeniu strony | Wtyczka bezpieczeństwa albo serwer blokuje hasła aplikacji lub nagłówek `Authorization`. |