Skip to main content

MCP Server Component

The SmartHopper MCP Server component (MCP, in SmartHopper → A. AI) starts a local Model Context Protocol HTTP server that exposes SmartHopper's tool catalog to external MCP clients such as Claude Desktop, Cursor, VS Code, Claude Code, or your own scripts.

MCP Server component

Parameters​

Inputs​

InputNicknameDefaultDescription
EnableEfalseSet to True to start the shared MCP server, or False to stop it.
PortP26929TCP port to listen on.
Bearer TokenT(empty)Optional secret token. When set, requests without Authorization: Bearer <token> are rejected with HTTP 401.
Allow EditingAEfalseExpose tools that create, wire, move, group, or edit components and scripts on the canvas.
Auto-approve changesAAfalseApply MCP-requested canvas edits immediately without showing the review dialog (Ctrl+Z undo is still recorded).
Allow View ControlAVfalseExpose viewport navigation tools (canvas_view).
Allow External ToolsETfalseExpose tools that reach outside the Grasshopper document (openWorldHint): local file reads/writes (file2md, rhino_*_3dm, gh_document_open/save), screenshots, web/forum fetches (web2md, Discourse), and AI provider calls (text2*, script_*, gh_generate, img2text, speech_generate, providers_models).

Outputs​

OutputNicknameDescription
UrlUHTTP endpoint URL (e.g., http://127.0.0.1:26929/mcp) to configure in your MCP client.
StatusSCurrent server status (Stopped, Running on ..., or error/warning details).

Security defaults​

  • Loopback-only, always — binds 127.0.0.1 and rejects non-loopback peers as well as foreign Host, Origin, or Referer headers (protecting against DNS rebinding and browser drive-by requests). There is no LAN/listen-on-all-interfaces mode.
  • Read-only, document-scoped surface by default — with all boolean flags at their false defaults, clients can only call local, read-only canvas inspection and GhJSON tools (gh_get, gh_list_components, gh_diff, gh_patch_validate, etc.).
  • Opt-in capabilities — enable Allow Editing for canvas mutations, Allow View Control for viewport movement, and Allow External Tools when you want the MCP client to read local files, capture screenshots, fetch web/forum pages, or invoke your configured AI providers.
  • Per-edit review — even with Allow Editing on, every canvas change still opens the review dialog unless Auto-approve changes is also enabled.
  • Warns when unauthenticated — if the server runs without a Bearer Token, the Status output warns explicitly that the endpoint is unauthenticated.

Step-by-step client configuration: Connect an MCP client.