SnelStart MCP Server

MCP (Model Context Protocol) server voor SnelStart B2B API integratie. Geeft Claude directe toegang tot je SnelStart administratie.

Wat kun je ermee?

• Facturen bekijken en analyseren
• Boekingen maken en bewerken
• BTW-overzichten genereren
• Artikelen beheren
• Documenten uploaden en downloaden
• En nog veel meer...

Quick Start

1. Clone en installeer

git clone https://github.com/mralbertzwolle/snelstart-mcp.git
cd snelstart-mcp
npm install
npm run build

2. Haal je SnelStart API keys op

1. Subscription Key:

   • Maak account op https://b2bapi-developer.snelstart.nl/
   • Abonneer op 'Verkenning'
   • Kopieer je Primary of Secondary key uit je profiel

2. Connection Key:

   • Log in op SnelStart Web
   • Ga naar Instellingen → Koppelingen
   • Klik op "Maatwerk SnelStart Software B.V."
   • Genereer een nieuwe koppelsleutel

3. Configureer Claude Desktop

Voeg toe aan ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "snelstart": {
      "command": "node",
      "args": ["/pad/naar/snelstart-mcp/dist/index.js"],
      "env": {
        "SNELSTART_ADMINS": "mijn-admin",
        "SNELSTART_MIJN-ADMIN_NAME": "Mijn Bedrijf BV",
        "SNELSTART_MIJN-ADMIN_SUBSCRIPTION_KEY": "jouw-subscription-key",
        "SNELSTART_MIJN-ADMIN_CONNECTION_KEY": "jouw-connection-key"
      }
    }
  }
}

4. Start Claude en vraag iets

"Laat mijn openstaande facturen zien"
"Maak een BTW-overzicht voor Q4 2025"
"Zoek klant Jansen"

Beschikbare Tools (59 totaal)

Administratie (5 tools)

Facturen (5 tools)

Relaties (2 tools)

Grootboek (4 tools)

Boekingen - Lezen (3 tools)

Boekingen - Schrijven (10 tools)

Artikelen - Lezen (8 tools)

Artikelen - Schrijven (3 tools)

Orders & Offertes (6 tools)

BTW (2 tools)

Documenten (4 tools)

Import (4 tools)

Overig (3 tools)

Meerdere Administraties

Je kunt meerdere administraties configureren:

SNELSTART_ADMINS=bedrijf1,bedrijf2

SNELSTART_BEDRIJF1_NAME="Bedrijf 1 BV"
SNELSTART_BEDRIJF1_SUBSCRIPTION_KEY=key1
SNELSTART_BEDRIJF1_CONNECTION_KEY=key1

SNELSTART_BEDRIJF2_NAME="Bedrijf 2 BV"
SNELSTART_BEDRIJF2_SUBSCRIPTION_KEY=key2
SNELSTART_BEDRIJF2_CONNECTION_KEY=key2

Wissel met: "Wissel naar bedrijf2"

Bekende Beperkingen

Roadmap: Productiekoppeling

Voor een gecertificeerde productiekoppeling (meerdere eindgebruikers) is nodig:

1. OAuth implementatie - Gebruikers loggen in via SnelStart
2. Webhook endpoint - Real-time events van SnelStart
3. Web portal - Gebruikers beheren hun koppelingen
4. Certificering - 12 dagen testperiode bij SnelStart

Zie docs/PRODUCTIE-KOPPELING-PLAN.md voor details.

Een web portal prototype staat klaar op: https://github.com/mralbertzwolle/snelstart-portal

Development

npm install          # Installeer dependencies
npm run build        # Compileer TypeScript
npm run dev          # Development mode (ts-node)
npx tsc --noEmit     # Type check

Project Structuur

snelstart-mcp/
├── src/
│   ├── index.ts                 # MCP Server entry point
│   ├── config/                  # Multi-admin configuratie
│   ├── integrations/snelstart/  # API client
│   ├── tools/                   # MCP Tools (read)
│   │   ├── admin.ts
│   │   ├── invoices.ts
│   │   ├── artikelen.ts
│   │   ├── download.ts          # Document download
│   │   └── write/               # Write tools
│   └── types/                   # TypeScript types
├── docs/
│   ├── snelstart-api-v2-endpoints.md
│   └── PRODUCTIE-KOPPELING-PLAN.md
└── data/                        # Lokale sync data (gitignored)

Links

• SnelStart B2B API Portal
• SnelStart API Documentatie
• MCP Protocol

License

MIT