sharepoint-mcp

MCP server pre SharePoint Online — správa listov, knižníc, stĺpcov, pohľadov, položiek a súborov priamo z AI agenta.

Štruktúra projektu

sharepoint-mcp/
├── .env.example          # Šablóna konfigurácie (skopíruj do .env)
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts          # MCP server + registrácia všetkých nástrojov
    ├── auth.ts           # MSAL browser login + file token cache
    ├── sharepoint.ts     # SharePoint REST klient (GET / POST / PATCH / DELETE / upload)
    ├── types.ts          # Zdieľané TypeScript typy (ColumnSpec, ViewSpec)
    ├── column-types.ts   # Mapovanie typov stĺpcov + buildFieldBody
    └── tools/
        ├── lists.ts      # Nástroje pre listy a knižnice
        ├── columns.ts    # Nástroje pre stĺpce
        ├── items.ts      # Nástroje pre položky
        ├── views.ts      # Nástroje pre pohľady
        └── files.ts      # Nástroje pre súbory

Dostupné nástroje (22)

Autentifikácia

Nevyžaduje app registration ani admin súhlas. Používa PnP Management Shell — well-known public client (31359c7f-bd7e-475c-86db-fdb8c937548e).

• Pri prvom spustení sa otvorí prehliadač → prihlásenie pod vlastným účtom → jednorazový consent
• Token je uložený v ~/.sharepoint-mcp/token-cache.json — ďalšie spustenia nevyžadujú login
• Jeden token pokrýva všetky site collections na tom istom tenante
• Prepínanie medzi site collections: zavolaj set_site s novou URL

Inštalácia a spustenie

# 1. Nainštaluj závislosti
npm install

# 2. Vytvor .env zo šablóny
cp .env.example .env
# Uprav SITE_URL v .env

# 3. Spusti vývojový server (voliteľné — Claude Code štartuje server sám)
npm run dev

.env

SITE_URL=https://contoso.sharepoint.com/sites/mysite

Konfigurácia MCP v Claude Desktop

Pridaj do claude_desktop_config.json (zvyčajne %APPDATA%\Claude\claude_desktop_config.json alebo na Windows %LOCALAPPDATA%\Packages\Claude_...\LocalCache\Roaming\Claude\claude_desktop_config.json):

Možnosť 1 — skompilovaný build (odporúčané)

Najprv sprav build projektu:

npm run build

Potom pridaj do konfigurácie (uprav cestu podľa svojho umiestnenia projektu):

{
  "mcpServers": {
    "sharepoint": {
      "command": "node",
      "args": ["C:/Users/Lukas/Documents/AI Projects/sharepoint-mcp/dist/index.js"]
    }
  }
}

Po každej zmene kódu treba znovu spustiť npm run build.

Možnosť 2 — priamo TypeScript cez tsx (len pre vývoj)

{
  "mcpServers": {
    "sharepoint": {
      "command": "npx",
      "args": ["tsx", "C:/Users/Lukas/Documents/AI Projects/sharepoint-mcp/src/index.ts"]
    }
  }
}

Pozor: cwd v konfigurácii Claude Desktop nefunguje spoľahlivo — vždy používaj absolútnu cestu v args.

Po uložení reštartuj Claude Desktop — server sa spustí automaticky pri prvom volaní nástroja.

Tip: Ak pracuješ na viacerých site collections, stačí na začiatku konverzácie zavolať set_site s príslušnou URL. Token sa znovu použije, prehliadač sa neotvorí.

Typy stĺpcov