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

# NoimosAI MCP-server

> Använd NoimosAI från Claude, ChatGPT, Cursor och andra MCP-kompatibla klienter.

## Översikt

NoimosAI MCP-servern exponerar din NoimosAI-arbetsyta via [Model Context Protocol](https://modelcontextprotocol.io). När den är ansluten kan MCP-kompatibla klienter chatta med NoimosAI-agenten, lista arbetsytor och integrationer samt publicera sociala inlägg direkt från klienten.

Två sätt att ansluta:

* **Remote MCP (rekommenderas)** — Hostad på `https://mcp.noimosai.com/mcp`. Browser-OAuth, ingen installation, körs som dig.
* **Local MCP (`@agos-labs/noimosai-mcp`)** — Kör servern lokalt via npm. Lämpar sig för headless / API-nyckel-flöden.

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

    ### Krav

    * Ett NoimosAI-konto (inloggad)
    * En klient som stöder Remote MCP / Custom Connectors

    ### Auktorisering

    Klienten registrerar sig själv, sedan öppnas webbläsaren för NoimosAI-inloggning och samtycke till scope `mcp:tools`. Efter samtycke utfärdas en åtkomsttoken och verktygsanrop körs som du.

    ### Anslutning

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

        I sessionen kör `/mcp`, slutför samtycket i webbläsaren och återgå till Claude Code.
      </Tab>

      <Tab title="Claude.ai / Desktop">
        Settings → Connectors → **Add custom connector** → URL `https://mcp.noimosai.com/mcp` → logga in och godkänn i webbläsaren.
      </Tab>

      <Tab title="ChatGPT Web">
        Lägg till en Custom MCP connector med URL `https://mcp.noimosai.com/mcp` och slutför samtycket. ChatGPT hittar inte automatiskt generiska `search` / `fetch`-verktyg — anropa NoimosAI-verktyg med namn.
      </Tab>
    </Tabs>

    ### Anmärkningar

    * Anropa alltid `post` först med `dryRun: true` för att granska payloaden. Utan `dryRun` publiceras inlägg på det riktiga sociala kontot.
    * För att koppla bort, ta bort connectorn i klienten.

    ### Felsökning

    * **Webbläsaren öppnar inte samtycket** — ta bort connectorn och lägg till den igen.
    * **Inga verktyg listas** — bekräfta att scope `mcp:tools` har beviljats och att kontot har minst en arbetsyta.
    * **Token har gått ut** — auktorisera om från klienten.
  </Tab>

  <Tab title="Local (npm)">
    Publicerad på npm som [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@agos-labs/noimosai-mcp). Körs som en underprocess av klienten.

    ### Krav

    * Node.js `>= 18`
    * En MCP-kompatibel klient (Claude Desktop, Cursor, VS Code, …)
    * En NoimosAI API-nyckel från teaminställningarna

    ### Konfiguration

    Ersätt `your-api-key` och `your-workspace-id` med värden från ditt NoimosAI-team.

    <Tabs>
      <Tab title="Claude Desktop">
        Lägg till i `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">
        Lägg till i `.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">
        Lägg till i `.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>

    Starta om klienten efter konfigurationsändringen så att MCP-servern läses in.

    ### Miljövariabler

    | Variabel              | Obligatorisk | Beskrivning                                                         |
    | --------------------- | ------------ | ------------------------------------------------------------------- |
    | `NOIMOS_API_KEY`      | Ja           | NoimosAI API-nyckel (finns under API-fliken i teaminställningarna). |
    | `NOIMOS_WORKSPACE_ID` | Nej          | Standardarbetsyte-ID när ett verktygsanrop utelämnar `workspaceId`. |
  </Tab>
</Tabs>

## Verktyg

Båda transporterna exponerar samma verktyg.

### `chat`

Skickar ett meddelande till NoimosAI-agenten. Returnerar strukturerad NoimosPostJson med agentens svar och eventuella extraherade sociala inlägg. Passar för marknadsanalys, skapande av sociala inlägg, SEO och innehållsgenerering.

| Parameter     | Typ      | Obligatorisk | Beskrivning                                                                                     |
| ------------- | -------- | ------------ | ----------------------------------------------------------------------------------------------- |
| `prompt`      | `string` | Ja           | Meddelande eller instruktion till agenten.                                                      |
| `workspaceId` | `string` | Nej          | Arbetsyte-ID. Standard: `NOIMOS_WORKSPACE_ID` (Local) eller det auktoriserade kontots standard. |
| `sessionId`   | `string` | Nej          | Sessions-ID för att fortsätta en konversation. Om utelämnad skapas en ny session.               |

### `list_workspaces`

Listar tillgängliga arbetsytor med ID och namn. Inga parametrar.

### `list_integrations`

Listar anslutna integrationer (sociala konton) i arbetsytan. Returnerar konto-ID:n (`providerAccountId`) som krävs av `post`-verktyget för varje post.

### `post`

Publicerar sociala inlägg. Tar emot data i NoimosPostJson-format som returneras av `chat`. Varje post måste innehålla `providerAccountId` (hämtas från `list_integrations`). Börja alltid med `dryRun: true` för att granska payloaden innan publicering.

| Parameter     | Typ       | Obligatorisk | Beskrivning                                                                            |
| ------------- | --------- | ------------ | -------------------------------------------------------------------------------------- |
| `posts`       | `array`   | Ja           | Array med poster i NoimosPostJson-format. Varje post kräver `providerAccountId`.       |
| `schedule`    | `string`  | Ja           | Publiceringstid. `"now"` för omedelbar eller `"YYYY-MM-DD HH:MM"` för schemalagd.      |
| `workspaceId` | `string`  | Nej          | Arbetsyte-ID. Standard: standardarbetsyta.                                             |
| `dryRun`      | `boolean` | Nej          | Om `true` visas bara vad som skulle skickas utan att publicera. Standardvärde `false`. |

## Relaterat

* [Vad är NoimosAI?](/sv/help-center/getting-started/what-is-noimosai)
* [NoimosAI CLI](/sv/developers/cli/overview)
* [npm-paket](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)