Grooper MCP: Difference between revisions

Revision as of 16:17, 22 September 2026

2026 BETA

This article covers new or changed functionality in the current or upcoming beta version of Grooper. Features are subject to change before version 2026's GA release. Configuration and functionality may differ from later beta builds and the final 2026 release.

Connecting a Grooper MCP Server to an AI harness

Claude Code/Claude Desktop

This guide will list the basic steps for hooking up a Grooper MCP Server to Claude Code. This will let you use Grooper tools from a Grooper MCP Server from:

A terminal window, by typing claude directly (the "Claude Code CLI").
The Code tab in Claude Desktop.

To get started:

Open Windows PowerShell.
Run the following command to install Claude Code. This may take a moment. Wait for the "Installation complete!" message at the end.

irm https://claude.ai/install.ps1 | iex

Close the PowerShell window and open a brand new one.
Run the following command to double-check Claude Code was installed. It should print a version number

claude --version

Run this command to add the Grooper MCP Server connection.

claude mcp add --transport http --scope user <NAME-IN-CLAUDE> "https://<GROOPER-HOST>/gws/mcp/<GROOPER-REPOSITORY-ID>/servers/<MCP-SERVER-NAME>"

<NAME-IN-CLAUDE>: Replace this with whatever you want to name the MCP server, as seen in Claude, for example grooper or grooper-prod or grooper-dev.
<GROOPER-HOST>: Replace this with the server host where the Grooper and GWS apps are installed.
<GROOPER-REPOSITORY-ID>: Replace this with the Grooper Repository's ID (You can grab this by going to the Design page, selecting the Root node and copying the GUID value from the "Repository ID" property).
<MCP-SERVER-NAME>: Replace this with whatever you named your MCP Server in Grooper.
--scope user: This is recommended to make the server available everywhere for your account, not just locally to a single folder (--scope local).

Run this command to verify you've registered the server and show its status.

claude mcp list

If Claude Desktop is open, close and re-open it.
Go to the Code tab, start a new session and enter "/mcp". You should see the MCP Server you just added in the list.
Start prompting requests! The following are safe, read-only requests that will get you started.
- List the Projects in my Grooper Repository and describe each Content Model.
- Show me the steps in the list specific process name here Batch Process and what each Activity is configured to do.
- List the most recent Production Batch and tell me what step it is on.
- Read the Create Batch Process skill from the Grooper server and summarize the recommended step order for scanned paper documents.

OpenCode

OpenCode is an open source AI coding agent available as a terminal-based interface or a desktop app. It's an effective and cost effective way to get connected to a Grooper MCP Server. OpenCode uses the AI SDK and Models.dev to support 75+ LLM providers and supports running local models on-premises.

These instructions assume you already have OpenCode installed and connected to a model provider.

You can download OpenCode at opencode.ai/download
You can refer to information on how to set up and configure OpenCode at opencode.ai/docs

MCP servers are added by editing the OpenCode config file on your machine.

Open Windows File explorer and go to C:\Users\<YOUR-USER-NAME>\.config\opencode
Open opencode.json in a text editor.
If no such "mcp" block in the JSON config exists, add the following entry to the bottom (before the ending } in the JSON):

  "mcp": {
    "<NAME-IN-OPENCODE>": {
      "type": "remote",
      "url": "https://<GROOPER-HOST>/gws/mcp/<GROOPER-REPOSITORY-ID>/servers/<MCP-SERVER-NAME>",
      "enabled": true
    }
  }

<NAME-IN-OPENCODE>: Replace this with whatever you want to name the MCP server, as seen in OpenCode, for example grooper or grooper-prod or grooper-dev.
<GROOPER-HOST>: Replace this with the server host where the Grooper and GWS apps are installed.
<GROOPER-REPOSITORY-ID>: Replace this with the Grooper Repository's ID (You can grab this by going to the Design page, selecting the Root node and copying the GUID value from the "Repository ID" property).
<MCP-SERVER-NAME>: Replace this with whatever you named your MCP Server in Grooper.

If there are other MCP servers listed in the "mcp" block, do not delete any entries in the block. Simply add your server (<NAME-IN-OPENCODE>": {...}) in the object.
Fully quit and reopen OpenCode for the changes to take effect.
In the desktop app, if you have "Server status" enabled in the Settings (General > Advanced), you can verify your MCP Server is connected by pressing the "Status" button in the top tool bar.
Start prompting requests! The following are safe, read-only requests that will get you started.
- List the Projects in my Grooper Repository and describe each Content Model.
- Show me the steps in the list specific process name here Batch Process and what each Activity is configured to do.
- List the most recent Production Batch and tell me what step it is on.
- Read the Create Batch Process skill from the Grooper server and summarize the recommended step order for scanned paper documents.

@@ Line 70: / Line 70: @@
 # Fully quit and reopen OpenCode for the changes to take effect.
 # In the desktop app, if you have "Server status" enabled in the Settings (General > Advanced), you can verify your MCP Server is connected by pressing the "Status" button in the top tool bar.
+# Start prompting requests! The following are safe, read-only requests that will get you started.
+#* <code>List the Projects in my Grooper Repository and describe each Content Model.</code>
+#* <code>Show me the steps in the ''list specific process name here'' Batch Process and what each Activity is configured to do.</code>
+#* <code>List the most recent Production Batch and tell me what step it is on.</code>
+#* <code>Read the Create Batch Process skill from the Grooper server and summarize the recommended step order for scanned paper documents.</code>