> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Łączenie klientów

> Połącz Remote lub Local MCP z klientem AI.

## Przegląd

Połącz Claude, ChatGPT Desktop, Codex, Cursor lub VS Code. Zwykle wybierz Remote bez instalacji i kluczy; Local do plików lub pracy bez interfejsu.

## Wybór połączenia

Wybierz według środowiska i lokalnych plików.

| Metoda | Zastosowanie | Uwierzytelnianie | Instalacja |
| - | - | - | - |
| Remote MCP | Zwykłe klienty AI | OAuth przeglądarki | Brak |
| Local MCP | Bez interfejsu lub pliki lokalne | Klucz NoimosAI | Node.js i pakiet npm |

> [!NOTE]
>
> Remote nie obsługuje `upload_media`, `upload_website_source` i `download_creation` dostępu lokalnego. Użyj Local.

## Połączenie Remote

Dodaj endpoint NoimosAI i autoryzuj w przeglądarce.

Przygotuj:

* Konto NoimosAI
* Klient MCP ze Streamable HTTP i OAuth

Użyj tego URL.

```text theme={null}
https://mcp.noimosai.com/mcp
```

Wykonaj instrukcje klienta.

> [tab] Claude Code
>
> W Claude Code dodaj endpoint tak.
>
> ```bash theme={null}
> claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp
> ```
>
> Uruchom `/mcp` w sesji, autoryzuj w przeglądarce i wróć.

> [tab] Claude.ai / Desktop
>
> W Claude.ai lub Claude Desktop dodaj własny konektor.
>
> Otwórz **Settings → Connectors → Add custom connector**, wpisz `https://mcp.noimosai.com/mcp`, zapisz, zaloguj się i autoryzuj.

> [tab] ChatGPT Desktop
>
> W ChatGPT Desktop dodaj serwer MCP.
>
> 1. Otwórz **Settings → MCP servers**, potem **Add server**.
> 2. Ustaw nazwę `NoimosAI`, transport **Streamable HTTP**, URL `https://mcp.noimosai.com/mcp`.
> 3. Zapisz i wybierz **Restart**.
> 4. Wybierz **Authenticate** i autoryzuj w przeglądarce.
>
> Wpisz `/mcp`, aby zobaczyć serwery. [Aktualny przewodnik OpenAI](https://learn.chatgpt.com/docs/extend/mcp) opisuje narzędzia Remote z pluginów w ChatGPT Web, bez lokalnych ustawień. Te kroki dotyczą Desktop.

> [tab] Codex
>
> W Codex CLI te polecenia dodają endpoint i rozpoczynają OAuth.
>
> ```bash theme={null}
> codex mcp add noimosai --url https://mcp.noimosai.com/mcp
> codex mcp login noimosai
> ```
>
> Sprawdź `codex mcp list`. ChatGPT Desktop, Codex CLI i rozszerzenie IDE współdzielą MCP tego samego hosta Codex.

> [tab] Cursor
>
> W Cursor dodaj do `.cursor/mcp.json` projektu.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Włącz NoimosAI w ustawieniach MCP i ukończ logowanie w przeglądarce.

> [tab] VS Code
>
> W VS Code dodaj do `.vscode/mcp.json` przestrzeni.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "http",
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Start serwera uruchamia OAuth w przeglądarce.

Sprawdź konto i `mcp:tools` na ekranie zgody. Połącz ponownie i sprawdź narzędzia.

## Połączenie Local

Local uruchamia [`@noimosai/mcp`](https://www.npmjs.com/package/@noimosai/mcp) z npm jako proces potomny klienta.

Przygotuj trzy rzeczy:

* Node.js 20 lub nowszy
* Klient MCP ze STDIO
* Klucz z karty API ustawień zespołu

Zastąp `your-api-key` kluczem. Dodaj `NOIMOS_WORKSPACE_ID` tylko dla stałej przestrzeni domyślnej.

> [!WARNING]
>
> Nie udostępniaj ani nie commituj konfiguracji z kluczami. Użyj zwykłego klucza; Developer Platform `nmp_` nie działa.

> [tab] Claude Code
>
> W Claude Code dodaj serwer tak.
>
> ```bash theme={null}
> claude mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env MCP_TOOL_TIMEOUT=900000 \
>   -- npx -y @noimosai/mcp
> ```

> [tab] Claude Desktop
>
> W Claude Desktop uzupełnij `claude_desktop_config.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Codex
>
> W Codex CLI dodaj serwer tak.
>
> ```bash theme={null}
> codex mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
>   -- npx -y @noimosai/mcp
> ```
>
> Pozwala na transfer tylko w folderze wykonania polecenia.

> [tab] Cursor
>
> W Cursor uzupełnij `.cursor/mcp.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> W VS Code uzupełnij `.vscode/mcp.json`.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "stdio",
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

Zmienne środowiskowe:

| Zmienna | Wymagana | Opis |
| - | - | - |
| `NOIMOS_API_KEY` | Tak | Klucz z karty API zespołu. |
| `NOIMOS_WORKSPACE_ID` | Nie | Domyślna przestrzeń przy braku `workspaceId`. |
| `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` | Nie | Dozwolone foldery; wiele ścieżek oddziel separatorem systemowym. |

Dopuszczaj tylko potrzebne foldery. Dla bieżącego podaj ścieżkę absolutną jako `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` w konfiguracji.

Uruchom klienta ponownie i sprawdź narzędzia. `chat` i `create_workspace_and_onboard` mogą trwać kilka minut; ustaw około 15 minut, jeśli można.

## Pierwsze narzędzia

Zacznij od odczytu przestrzeni i danych bez zmian.

Poproś kolejno:

1. „Wyświetl moje przestrzenie NoimosAI”.
2. „Sprawdź markę i konta wybranej przestrzeni”.
3. „Napisz szkic LinkedIn na tej podstawie. Pokaż tekst bez publikacji”.

Pierwsze używają odczytów jak `list_workspaces` i `get_workspace_context`. Trzecie też nie publikuje: sprawdź treść przed kolejną decyzją.

## Problemy połączenia

Sprawdź odpowiedni wariant:

* **Brak zgody Remote** — Usuń i dodaj połączenie.
* **Brak narzędzi Remote** — Sprawdź `mcp:tools` i obecność przestrzeni.
* **Token Remote wygasł** — Autoryzuj ponownie.
* **Local nie startuje** — Sprawdź Node.js 20+, `npx`, pakiet i klucz.
* **Local nie wybiera przestrzeni** — Sprawdź `NOIMOS_WORKSPACE_ID` lub `workspaceId` wywołania.
* **Local nie czyta pliku** — Sprawdź folder dozwolony przez `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`.

## Powiązane strony

Te strony opisują narzędzia i inne dostępy.

* [Używanie narzędzi](https://docs.noimosai.com/pl/developers/mcp/tools.md)
* [Podstawy](https://docs.noimosai.com/pl/developers/cli/overview.md)
* [Standardowy przewodnik połączenia MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.