> ## 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.

# Serwer MCP NoimosAI

> Korzystaj z NoimosAI z poziomu Claude, ChatGPT, Cursor i innych klientów zgodnych z MCP.

## Przegląd

Serwer MCP NoimosAI udostępnia obszar roboczy NoimosAI przez [Model Context Protocol](https://modelcontextprotocol.io). Po połączeniu klient zgodny z MCP może rozmawiać z agentem NoimosAI, listować obszary robocze i integracje oraz publikować posty społecznościowe bezpośrednio z klienta.

Dwa sposoby połączenia:

* **Remote MCP (zalecane)** — Hostowany pod `https://mcp.noimosai.com/mcp`. OAuth w przeglądarce, bez instalacji, działa w Twoim imieniu.
* **Local MCP (`@agos-labs/noimosai-mcp`)** — Uruchom serwer lokalnie przez npm. Nadaje się do scenariuszy headless / z kluczem API.

<Tabs>
  <Tab title="Remote (zalecane)">
    Endpoint: `https://mcp.noimosai.com/mcp`

    ### Wymagania

    * Konto NoimosAI (zalogowane)
    * Klient obsługujący Remote MCP / Custom Connectors

    ### Autoryzacja

    Klient rejestruje się sam, następnie otwiera się przeglądarka z logowaniem do NoimosAI i zgodą na zakres `mcp:tools`. Po zgodzie wydawany jest token dostępu, a wywołania narzędzi działają w Twoim imieniu.

    ### Połączenie

    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={null}
        claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp
        ```

        W sesji uruchom `/mcp`, dokończ zgodę w przeglądarce, a następnie wróć do Claude Code.
      </Tab>

      <Tab title="Claude.ai / Desktop">
        Settings → Connectors → **Add custom connector** → URL `https://mcp.noimosai.com/mcp` → zaloguj się i zatwierdź w przeglądarce.
      </Tab>

      <Tab title="ChatGPT Web">
        Dodaj Custom MCP connector z URL `https://mcp.noimosai.com/mcp`, następnie zatwierdź zgodę. ChatGPT nie wykrywa automatycznie ogólnych narzędzi `search` / `fetch` — wywołuj narzędzia NoimosAI po nazwie.
      </Tab>
    </Tabs>

    ### Uwagi

    * Zawsze wywołuj `post` najpierw z `dryRun: true`, aby sprawdzić zawartość. Bez `dryRun` posty trafią na prawdziwe konto społecznościowe.
    * Aby się rozłączyć, usuń connector z klienta.

    ### Rozwiązywanie problemów

    * **Przeglądarka nie otwiera ekranu zgody** — usuń connector i dodaj go ponownie.
    * **Brak listy narzędzi** — sprawdź, czy zakres `mcp:tools` został przyznany i czy konto ma przynajmniej jeden obszar roboczy.
    * **Token wygasł** — autoryzuj ponownie z klienta.
  </Tab>

  <Tab title="Local (npm)">
    Publikowany w npm jako [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@agos-labs/noimosai-mcp). Działa jako proces potomny klienta.

    ### Wymagania

    * Node.js `>= 18`
    * Klient zgodny z MCP (Claude Desktop, Cursor, VS Code, …)
    * Klucz API NoimosAI z ustawień zespołu

    ### Konfiguracja

    Zamień `your-api-key` i `your-workspace-id` na wartości z ustawień zespołu NoimosAI.

    <Tabs>
      <Tab title="Claude Desktop">
        Dodaj do `claude_desktop_config.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="Cursor">
        Dodaj do `.cursor/mcp.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="VS Code">
        Dodaj do `.vscode/mcp.json`:

        ```json theme={null}
        {
          "servers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>

    Po zmianie konfiguracji uruchom klienta ponownie, aby wczytał serwer MCP.

    ### Zmienne środowiskowe

    | Zmienna               | Wymagana | Opis                                                               |
    | --------------------- | -------- | ------------------------------------------------------------------ |
    | `NOIMOS_API_KEY`      | Tak      | Klucz API NoimosAI (dostępny w zakładce API ustawień zespołu).     |
    | `NOIMOS_WORKSPACE_ID` | Nie      | Domyślne ID obszaru roboczego, gdy wywołanie pomija `workspaceId`. |
  </Tab>
</Tabs>

## Narzędzia

Oba transporty udostępniają te same narzędzia.

### `chat`

Wysyła wiadomość do agenta NoimosAI. Zwraca ustrukturyzowany NoimosPostJson z odpowiedzią agenta i wyodrębnionymi postami społecznościowymi. Nadaje się do analiz marketingowych, tworzenia postów społecznościowych, SEO i generowania treści.

| Parametr      | Typ      | Wymagany | Opis                                                                                    |
| ------------- | -------- | -------- | --------------------------------------------------------------------------------------- |
| `prompt`      | `string` | Tak      | Wiadomość lub instrukcja wysyłana do agenta.                                            |
| `workspaceId` | `string` | Nie      | ID obszaru roboczego. Domyślnie `NOIMOS_WORKSPACE_ID` (Local) lub konta autoryzowanego. |
| `sessionId`   | `string` | Nie      | ID sesji do kontynuacji rozmowy. Jeśli pominięty, tworzona jest nowa sesja.             |

### `list_workspaces`

Listuje dostępne obszary robocze wraz z ID i nazwą. Brak parametrów.

### `list_integrations`

Listuje podłączone integracje (konta społecznościowe) obszaru roboczego. Zwracane ID kont (`providerAccountId`) są wymagane w każdym wpisie narzędzia `post`.

### `post`

Publikuje posty społecznościowe. Przyjmuje dane w formacie NoimosPostJson zwracane przez `chat`. Każdy wpis musi zawierać `providerAccountId` (pobierany z `list_integrations`). Zawsze zaczynaj od `dryRun: true`, aby sprawdzić payload przed publikacją.

| Parametr      | Typ       | Wymagany | Opis                                                                                  |
| ------------- | --------- | -------- | ------------------------------------------------------------------------------------- |
| `posts`       | `array`   | Tak      | Tablica postów w formacie NoimosPostJson. Każdy wpis wymaga `providerAccountId`.      |
| `schedule`    | `string`  | Tak      | Czas publikacji. `"now"` natychmiast lub `"YYYY-MM-DD HH:MM"` zaplanowane.            |
| `workspaceId` | `string`  | Nie      | ID obszaru roboczego. Domyślnie obszar domyślny.                                      |
| `dryRun`      | `boolean` | Nie      | Gdy `true`, pokazuje, co zostałoby wysłane, bez publikacji. Wartość domyślna `false`. |

## Powiązane

* [Co to jest NoimosAI?](/pl/help-center/getting-started/what-is-noimosai)
* [NoimosAI CLI](/pl/developers/cli/overview)
* [Pakiet npm](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)