You kunt “attach the page that shows the problem” omzetten in één prompt. De GroupDocs.Viewer.Mcp‑server rendert de pagina’s die je opgeeft uit een PDF‑, Word‑, Excel‑ of PowerPoint‑bestand en slaat elke pagina op als een PNG met een voorspelbare bestandsnaam, lokaal op je machine, zodat Claude, Cursor of GitHub Copilot de afbeeldingen kan produceren voor een bugrapport, een review‑opmerking of een dia:
Render pagina’s 1, 4 en 9 van de specificatie en vertel me waar de bestanden zich bevinden.
De stapsgewijze versie met configuratie en probleemoplossing staat in de documentatie: Hoe maak je paginabeelden van documenten voor rapporten en tickets.
Waarom überhaupt paginabeelden automatiseren?
Een paginabeeld is het goedkoopste bewijs dat er bestaat. Een support‑engineer voegt de factuurpagina toe die het verkeerde totaal toont; een reviewer plaatst een miniatuur van elke gewijzigde pagina in de review‑notities; een presentator heeft één diagram nodig, onbewerkte. Handmatig betekent dit telkens het bestand openen, de pagina vinden, een screenshot maken en het resultaat een naam geven. Het aantal pagina’s verschilt per bestand, waardoor het werk nooit goed in batches kan worden uitgevoerd.
Een agent kan het repetitieve deel doen als het renderen wordt uitgevoerd door een echte engine in plaats van door de agent die er één nabootst. De engine pagineert het document op dezelfde manier als het document zelf pagineert en schrijft elke keer hetzelfde type PNG.
Wat is de workflow?
- Plaats de bestanden waar de server ze kan zien. Koppel de map die de documenten bevat, of het nu PDF‑bestanden of Word‑bestanden zijn, zodat het renderen van een DOCX‑paginabeeld op dezelfde manier werkt. De server leest van het opslagpad en schrijft de afbeeldingen naar het uitvoerpad, dat je apart kunt houden met
GROUPDOCS_MCP_OUTPUT_PATH. - Controleer het aantal pagina’s. Prompt: “Hoeveel pagina’s heeft de specificatie?” De agent roept
get_view_infoaan en leestpageCount. Dit is belangrijk omdatrender_pagegeen paginanummer buiten het einde van het document afwijst. - Noem de pagina’s. Prompt: “Render pagina’s 1, 4 en 9 van de specificatie en vertel me waar de bestanden zich bevinden.” De agent roept
render_pagedrie keer aan, één keer per pagina. - Verzamel de bestandsnamen. De bestanden zijn
specification_page1.png,specification_page4.pngenspecification_page9.png, in de uitvoermap. De agent rapporteert de paden. - Voeg ze toe. Als je client ook een issue‑tracker of chat‑MCP‑server heeft aangesloten, vraag de agent dan de bestanden aan het ticket of bericht toe te voegen. Die stap maakt gebruik van de tools van de andere server, niet van deze.
Als je alleen de bestanden wilt, geef dat dan aan, zodat de agent niet elke afbeelding beschrijft:
Sla de afbeeldingen gewoon op; je hoeft ze niet te beschrijven.
Wat beslist de agent, en wat doet de engine?
| Beslissing of actie | Agent | Engine |
|---|---|---|
| Welke pagina’s zijn relevant | Mapt “de pagina’s met de prijzentabel” naar paginanummers, na het renderen of inspecteren | Niets |
| Of de pagina bestaat | Roept get_view_info aan en vergelijkt |
Retourneert pageCount en paginagroottes |
| Renderen | Roept render_page één keer per pagina aan |
Produceert de PNG |
| Bestandsnaamgeving | Rapporteert het opgeslagen pad | Slaat op als <source-stem>_page<N>.png |
| Toevoegen aan een ticket | Gebruikt de tool van een andere server | Niets |
Voorbeeldsessie
Een illustratie gebaseerd op de gedocumenteerde output‑namen, geen vastgelegde screenshot.
Jij: Render pagina's 1, 4 en 9 van de specificatie en vertel me waar de bestanden zich bevinden. Sla de afbeeldingen gewoon op; beschrijven is niet nodig.
Agent: [roept render_page aan voor pagina 1, pagina 4 en pagina 9]
Opgeslagen:
<output folder>/specification_page1.png
<output folder>/specification_page4.png
<output folder>/specification_page9.png
Hoe houd ik de set klein?
Renderen gebeurt één pagina per oproep, en elke afbeelding wordt inline teruggestuurd naar de agent. Vragen om tien pagina’s betekent tien oproepen en tien afbeeldingen in het gesprek. Vraag alleen de pagina’s die je nodig hebt. Een verstandige regel is om de pagina’s vóór het renderen te selecteren, gebruikmakend van het paginacount en, bij lange documenten, een inhoudsopgave.
Typische toepassingen
- Bugrapporten. De pagina van de handleiding of de factuur die het probleem toont.
- Documentreviews. Eén afbeelding per gewijzigde pagina in de review‑notities.
- Dia’s. Een afbeelding van het diagram dat je wilt, zonder het opnieuw te formatteren.
Eerlijke beperkingen
- Evaluatiemodus. Gerenderde pagina’s bevatten een evaluatiewatermerk, en een serverproces opent maximaal 15 documenten. Als de afbeeldingen je team verlaten, vraag dan eerst “Is de viewer‑server gelicentieerd?”, zodat de agent
get_license_statusaanroept. - Eén pagina per oproep. Er is geen multi‑pagina‑tool. Een batch is een reeks oproepen.
- Alleen PNG. Het formaat is vast; resolutie is geen parameter die je via de tool kunt instellen.
- Een verkeerd paginanummer geeft nog steeds een afbeelding. Een bestand genaamd
_page12.pngis pagina 12 alleen als het document 12 pagina’s heeft. Controleer eerst het aantal.
FAQ
Hoe converteer ik een PDF‑pagina naar een afbeelding met een AI‑agent? Verbind de GroupDocs.Viewer.Mcp‑server met je client en vraag om de pagina op nummer. De agent roept render_page aan en de PNG wordt opgeslagen in de uitvoermap als <name>_page<N>.png.
Hoe voeg ik een documentpreview toe aan een ticket met een AI‑agent? De Viewer‑server maakt het afbeeldingsbestand aan. Het toevoegen ervan vereist een issue‑tracker MCP‑server die met dezelfde client is verbonden, wat een aparte server met eigen tools is.
Kan ik document‑thumbnails lokaal genereren? Ja. De engine draait in het serverproces op je machine, en de afbeeldingen worden weggeschreven naar de uitvoermap die je configureert.
Dieper duiken
- Documentatie, canonieke handleiding: Hoe maak je paginabeelden van documenten voor rapporten en tickets
- Documentatie‑hub: GroupDocs.Viewer MCP Server
- Begin hier: Multimodale agents hebben pixels nodig, niet alleen tekst
- Gerelateerd: 3 vragen die een AI‑agent een document moet stellen voordat het wordt gerenderd
- Gerelateerd: Wanneer het antwoord in de grafiek staat: AI‑agents die diagrammen en scans lezen via MCP
- On‑premise en beveiligingsmodel: 3 architecturen voor AI‑documentverwerking, en diegene die bestanden binnen je netwerk houdt
- Vragen: GroupDocs Viewer forum
- Bron: GroupDocs.Viewer.Mcp on GitHub