inovia-m365-mcp

Microsoft 365 MCP server pre inovia.sk — firemné nástroje priamo v Claude Code a Cowork.

Čo to robí

Napíš /inovia a Claude zobrazí čo vie robiť. Aktuálne dostupné funkcie:

• Ranný prehľad — dnešné stretnutia z Outlooku + neprečítané e-maily
• Hľadanie kolegu — kontakt, oddelenie, manažér, tím
• Kalendár pre obdobie — stretnutia pre ľubovoľný deň alebo týždeň
• Marketing a komunikácia — tvorba obsahu podľa komunikačného manuálu INOVIA

Ďalšie plánované funkcie: pozri ROADMAP.md.

Pre zamestnancov — Claude Cowork (plugin)

Najjednoduchší spôsob — žiadna inštalácia Node.js ani terminál.

Krok 1 — Stiahni a nainštaluj plugin

1. Stiahni súbor inovia.zip
2. V Claude Cowork klikni na Customize → Browse plugins → Upload plugin
3. Vyber stiahnutý súbor

Krok 2 — Pripoj svoj účet

1. Otvor v prehliadači: https://inovia-m365-mcp-521967815165.europe-west1.run.app/auth/login
2. Prihlás sa svojím @inovia.sk Microsoft účtom
3. Skopíruj svoju osobnú URL adresu MCP servera zo stránky
4. V Cowork: Customize → Add custom connector
5. Zadaj názov inovia-m365 a skopírovanú URL → klikni Add

Platnosť prihlásenia je 30 dní. Po vypršaní zopakuj kroky 1–5.

Pre zamestnancov — Claude Code (vývojári)

Krok 1 — Pridaj MCP server

claude mcp add inovia-m365 --transport http https://inovia-m365-mcp-521967815165.europe-west1.run.app/mcp

Krok 2 — Pripoj svoj účet

1. Otvor v prehliadači: https://inovia-m365-mcp-521967815165.europe-west1.run.app/auth/login
2. Prihlás sa svojím @inovia.sk Microsoft účtom
3. Skopíruj svoju osobnú URL adresu MCP servera
4. Aktualizuj MCP konfiguráciu:

claude mcp remove inovia-m365
claude mcp add inovia-m365 --transport http <tvoja-osobná-url>

Krok 3 — Nainštaluj skill

mkdir -p ~/.claude/skills/inovia
cp skill/inovia/SKILL.md ~/.claude/skills/inovia/SKILL.md

Krok 4 — Otestuj

Napíš /inovia v Claude Code.

Pre IT administrátora — nastavenie servera

Tento krok treba spraviť raz pre celú firmu.

1. Registrácia aplikácie v Azure AD

1. Prihlás sa do Azure Portal s admin účtom inovia.sk
2. Choď na Microsoft Entra ID → App registrations → New registration
3. Vyplň:
   • Name: inovia-m365-mcp
   • Supported account types: Accounts in this organizational directory only
4. Klikni Register
5. Poznač si Application (client) ID a Directory (tenant) ID

2. Redirect URI a ID tokeny

1. V registrácii choď na Authentication → Add a platform → Web
2. Redirect URI: https://inovia-m365-mcp-521967815165.europe-west1.run.app/auth/callback
3. Zaškrtni ID tokens (Implicit grant)
4. Klikni Save

3. Client Secret

1. Choď na Certificates & secrets → New client secret
2. Zvol platnosť (napr. 24 mesiacov), klikni Add
3. Okamžite skopíruj hodnotu — po opustení stránky ju neuvidíš

4. API oprávnenia

1. Choď na API permissions → Add a permission → Microsoft Graph → Application permissions
2. Pridaj:
   • Calendars.Read
   • Mail.Read
   • User.Read.All
3. Klikni Grant admin consent for inovia.sk

5. Nasadenie na Cloud Run

PROJECT_ID=<tvoj-project-id>
IMAGE=europe-west1-docker.pkg.dev/$PROJECT_ID/cloud-run-source-deploy/inovia-m365-mcp:latest

gcloud builds submit --region=europe-west1 --tag=$IMAGE .
gcloud run deploy inovia-m365-mcp --image=$IMAGE --region=europe-west1 --platform=managed --allow-unauthenticated

Pridaj tieto premenné v Cloud Run → Variables & Secrets:

Lokálne spustenie (stdio)

Pre vývoj a testovanie bez Cloud Run.

Predpoklady

• Node.js 20+

Inštalácia

git clone https://github.com/stuposk/inovia-m365-mcp
cd inovia-m365-mcp
npm install
npm run build

Konfigurácia

cp .env.example .env

Doplň do .env:

AZURE_CLIENT_ID=xxxx
AZURE_TENANT_ID=xxxx
AZURE_CLIENT_SECRET=xxxx
[email protected]

Registrácia v Claude Code

claude mcp add --scope user inovia-m365 -- node /cesta/k/inovia-m365-mcp/dist/server.js

Štruktúra projektu

inovia-m365-mcp/
├── src/
│   ├── server.ts          # MCP server — HTTP (Cloud Run) aj stdio (lokálne)
│   ├── auth.ts            # Microsoft OAuth + JWT session tokeny
│   ├── graph.ts           # Microsoft Graph API volania
│   ├── setup.ts           # Validácia konfigurácie
│   └── tools/
│       ├── capabilities.ts    # get_capabilities — dynamický zoznam funkcií
│       ├── skill-context.ts   # get_skill_context — inštrukcie z data/skills/
│       ├── calendar.ts        # get_today_events
│       ├── mail.ts            # get_new_messages
│       ├── users.ts           # find_colleague, get_department_members, get_org_chart
│       └── marketing.ts       # get_marketing_guide
├── data/
│   ├── marketing/
│   │   └── guide.md           # Komunikačný manuál INOVIA
│   └── skills/
│       └── daily-briefing/
│           └── guide.md       # Inštrukcie pre ranný prehľad
├── skill/
│   └── inovia/
│       └── SKILL.md           # Skill pre Claude Code
├── plugin/                    # Claude Cowork plugin
│   ├── .claude-plugin/
│   │   └── plugin.json        # Plugin manifest
│   ├── skills/
│   │   └── inovia/
│   │       └── SKILL.md       # Skill pre Cowork
│   └── README.md
├── CHANGELOG.md
├── ROADMAP.md
└── Dockerfile

Riešenie problémov

Nástroje nefungujú — "authentication required"
→ Token vypršal alebo nie je nastavený. Navštív /auth/login a aktualizuj URL.

"Nepovolený účet"
→ Prihlasuj sa výhradne @inovia.sk Microsoft účtom.

"Graph auth failed"
→ Skontroluj, či IT admin nastavil správne AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET a udelil admin consent.

"Resource not found" alebo prázdny kalendár
→ Skontroluj, či admin consent zahŕňa Calendars.Read, Mail.Read a User.Read.All (Application permissions).