Met Claude Code koppel je een Craft-app via een eigen MCP-server. Kies eerst of de configuratie alleen voor jou in dit project geldt, voor al je projecten geldt of met een project wordt gedeeld. Gaat een PhotoCraft-batch halverwege mis, controleer dan de documentstatus en geschiedenis: eerder geslaagde stappen blijven staan.
Kies de juiste MCP-scope
MCP staat voor Model Context Protocol: een manier waarop Claude Code verbinding maakt met externe tools. De officiële documentatie van Claude Code beschrijft drie scopes, met elk een eigen bereik en configuratiebestand.
| Scope | Bereik | Configuratiebestand | Delen en goedkeuring |
| Lokaal | Huidig project, alleen voor jou | ~/.claude.json | Niet gedeeld met het team |
| Gebruiker | Al je projecten | ~/.claude.json | Niet gedeeld met het team |
| Project | Huidig project | .mcp.json in de projectmap | Deelbaar via versiebeheer; Claude Code vraagt in interactieve sessies om goedkeuring voordat het een projectserver gebruikt |
Kies lokaal als de server alleen bij dit project en jouw account hoort. Met de gebruikersscope geldt de configuratie voor je andere projecten. De projectscope past bij een gedeelde configuratie; een vermelding in .mcp.json geeft de server niet vanzelf toestemming om te draaien. Claude Code vraagt in interactieve sessies eerst om goedkeuring. De officiële MCP-documentatie van Claude Code beschrijft ook de configuratiepaden en scopes.
Een MCP-server toevoegen en controleren
Noteer vóór het toevoegen de opdracht en argumenten van de Craft-app die je wilt koppelen. De Craft-apps hebben elk hun eigen MCP-server en CLI-opties, zo meldde pasqualepillitteri.it.
- Bepaal het bereik. Kies lokaal, gebruiker of project aan de hand van wie de server moet kunnen gebruiken.
- Voeg de server toe. Claude Code geeft voor een lokale stdio-server deze opdrachtvorm:
claude mcp add [options] <name> -- <command> [args...]Het scheidingsteken--geeft aan dat de opdracht en argumenten erna voor de server zijn. Vervang de placeholders door de naam, CLI-opdracht en argumenten van de gekozen app; de Craft-opdracht verschilt per app. - Controleer de status. Gebruik
claude mcp listof/mcpom MCP-servers te beheren en hun status te bekijken. Een melding datclaude mcp addde configuratie heeft weggeschreven, is op zichzelf nog geen bevestiging dat de server verbinding heeft gemaakt; pasqualepillitteri.it beschreef dat onderscheid bij de Craft-installatie.
Controleer ook wat de app oplevert
Een zichtbare serverstatus vertelt je niet of het resultaat van een opdracht klopt. In de testbeschrijving van pasqualepillitteri.it liep een grafiek in DeckCraft over de titel van een dia. Een eerste brief in WordCraft besloeg twee pagina’s in plaats van één. Controleer dus ook het document of de uitvoer van de specifieke taak, niet alleen de MCP-status. De beschreven Craft-tests zijn waarnemingen van die publicatie, geen algemene prestatiegarantie voor elke app of versie.
Waar de bestandsgrenzen ophouden
PhotoCraft kan met ingestelde lees- en schrijfmappen de bestandstoegang van zijn eigen server begrenzen. Dat maakt die grens niet automatisch van toepassing op andere Claude Code-tools. In de testbeschrijving van pasqualepillitteri.it kon FilmCraft een gerenderd frame niet opslaan op het gekozen pad; daarna gebruikte Claude een shell-tool van Claude Code om het bestand daar op te slaan. De serverbeperking gold dus niet voor die afzonderlijke tool. De PhotoCraft-documentatie beschrijft de grenzen voor bestandspaden; de MCP-documentatie van Claude Code waarschuwt om een server te vertrouwen voordat je ermee verbinding maakt.
Herstel na een mislukte PhotoCraft-batch
Een command_batch in PhotoCraft is niet atomair: als een latere stap mislukt, blijven eerder geslaagde stappen toegepast. Controleer na een fout eerst de documentstatus en geschiedenis voordat je de batch opnieuw uitvoert. De PhotoCraft-documentatie adviseert voor experimenten een document te dupliceren of een nieuw document te maken.
Ongedaan maken draait wijzigingen in het document terug, maar verwijdert geen bestanden die al naar schijf zijn geschreven. Behandel zulke uitvoerbestanden daarom apart bij het herstellen van een mislukte batch.
