Manisma
Probeer gratis
In deze documentatie
Docs/NL

Koppel je AI-assistent

Manisma kan verbinding maken met een AI-assistent die je al gebruikt, zoals Claude Desktop, Claude Code, de ChatGPT-desktopapp of de Codex CLI. De koppeling gebruikt het open Model Context Protocol. Je kunt dan vragen stellen en planningswerk uitvoeren in het chatvenster van je assistent.

Jouw assistent, jouw AI

Je eigen assistent doet het denkwerk. Manisma levert de planning en de gegevens, maar gebruikt voor deze koppeling geen eigen AI. De koppeling verbruikt ook geen AI-acties uit je Manisma-abonnement.

De knop AI-voorstel in Manisma staat hier los van. Die functie gebruikt wel de AI van Manisma en de AI-acties uit je abonnement.

Wat je assistent kan doen

Je assistent kan opdrachten, klanten, techniekers, materiaal, taaktypes en toestellen opzoeken. Hij kan opdrachten en klanten aanmaken en wijzigen, een opdracht met een technieker inplannen en een planningsvoorstel aanvragen. Hij kan nooit iets verwijderen.

Een sleutel maken

Open Beheer → API-sleutels, maak een sleutel en kopieer hem meteen. De sleutel wordt maar één keer getoond. Lezen, schrijven en plannen zijn aparte rechten. Met een sleutel voor alleen lezen kun je dus wel opzoeken, maar niets wijzigen. Behandel de sleutel als een wachtwoord.

De koppeling installeren

Voor alle routes is Node.js 22 of nieuwer nodig. Controleer de geïnstalleerde versie:

node --version

Haal de API-sleutel op via Beheer → API-sleutels. De sleutel wordt één keer getoond en ziet eruit als msk_ gevolgd door 40 hexadecimale tekens. Lezen, schrijven en plannen zijn aparte rechten.

Route 1: Claude Desktop

  1. Download https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Open het gedownloade bestand. Claude Desktop toont een installatievenster.
  3. Plak de API-sleutel wanneer daarom wordt gevraagd. Deze wordt veilig opgeslagen.

Je hoeft geen bestand te bewerken en geen terminal te gebruiken.

Route 2: Claude Code

  1. Download https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Open een terminal in de map met de download en voer dit uit:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
claude mcp add manisma -e MANISMA_API_KEY=msk_your_key_here -- node ~/manisma-mcp/dist/index.js
  1. Vervang msk_your_key_here door de API-sleutel.
  2. Gebruik in Claude Code de opdracht /mcp om de verbinding te controleren.

Route 3: Codex CLI en de ChatGPT-desktopapp

  1. Download https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Open een terminal in de map met de download en pak het bestand uit:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
  1. Voeg dit blok toe aan ~/.codex/config.toml en vervang het pad en de sleutel. Het pad moet absoluut zijn, want ~ wordt in dit bestand niet uitgebreid.
[mcp_servers.manisma]
command = "node"
args = ["/home/you/manisma-mcp/dist/index.js"]
env = { MANISMA_API_KEY = "msk_your_key_here" }
  1. Voer codex mcp list uit. Daar moet manisma als enabled staan.

Op Windows is het .mcpb-bestand een ZIP-archief. Als Windows het niet kan uitpakken, wijzig je de extensie in .zip en kies je Alles uitpakken.

Wat je kunt verwachten

Je assistent vraagt om bevestiging voordat hij iets wijzigt en behandelt één opdracht tegelijk. Een planningsvoorstel wordt eerst getoond en pas toegepast nadat je het bevestigt.

De assistent kan werkuren en verlofdagen niet zien. Controleer een voorgesteld tijdstip daarom aan de hand van de echte planning. Planningsvoorstellen zijn beperkt tot enkele aanvragen per tien minuten.

Beperkingen

De koppeling werkt met de gegevens die in Manisma zijn opgeslagen. Ze vervangt het planbord niet en is slechts zo actueel als wat is opgeslagen.

Nog vragen over Manisma?

Neem contact op →