Skip to main content
Version: v2 · 2.8.0

Connect an AI application

Install the Glyphs components after completing the Glyphs/Python prerequisites, then configure your AI client from Setup. Individual connection cards and Install All support all four clients below, including configuration when the client is not detected. Install the client itself separately; configuring a connection does not install that application.

ClientSetup connectionAfter configuration
CodexLocal HTTP MCP connection and managed skillsReload the configured Codex host and check the Glyphs MCP tools.
Claude CodeLocal HTTP MCP connection and managed skillsStart a new/reloaded client session so it reads the updated configuration.
Claude DesktopLocal stdio proxy to the HTTP serverQuit and reopen Claude Desktop to load the local connection.
CursorInstaller-owned local plugin with connection metadata and skillsReload/enable the local Glyphs MCP plugin and refresh its tools.

Configuration backs up existing settings and preserves unrelated entries. Modified or unowned Cursor plugin content is reported as a conflict; use the card's guidance rather than deleting it blindly. After a failure, retry the affected card. A configured card does not establish a live server or ready Glyphs bridge.

HTTP connection​

  1. Start the server through Edit → Glyphs MCP Server….
  2. Click Copy URL to get the configured endpoint. The default local MCP URL is http://127.0.0.1:9680/mcp/.
  3. Add that URL to a local client that supports Streamable HTTP MCP, or use the installer's supported connection option.
  4. Refresh the client's tools and call get_status, then list_documents.

Stable 2.8.0 exposes 22 tools, including the optional show_edit_workflow card. Check get_status for the capabilities available on your connection. Tool reference

The local MCP URL connects an AI application running on the same Mac. The internal Glyphs bridge connects the MCP server to Glyphs.

Optional agent plugin​

The optional agent package supplies workflow skills and connection metadata. Use the package version that matches your installed runtime. Skills and optional plugins

Ordinary conversation tools return text and structured results. The optional show_edit_workflow opens one standard MCP App. Claude Desktop can use its existing local stdio connection; its proxy forwards resources and UI metadata. Cursor documents standard MCP Apps support. Codex must be checked against its actual host build; installing ChatGPT alone does not configure this local connection or prove card support. CLI clients and hosts without interactive support use the same actions in text. Optional native choice controls can present these choices; separate client-specific cards are not required. See conversation edits. Installed-version qualification is recorded separately from documented support.

The scoped Sonoma VM qualification used Claude Desktop. Cursor was excluded from that VM run at the maintainer's request; configuration/source checks and local Mac evidence do not qualify every client version. Use actual host capability negotiation and a small first session to verify your connection, with text replies if the interactive card is unavailable.

After a change​

If you change the MCP port, use Edit → Glyphs MCP Server… → Copy URL and update the client's connection. After installing new native bundles, restart Glyphs. After changing an agent package, refresh the client according to its own settings. Keep one intended server per MCP port and avoid duplicate connections to the same server.

Compare the expected version and skills digest from get_status.agentPackage with the installed package's glyphs-mcp-agent.json. Refresh a configured local Codex plugin with codex plugin add glyphs-mcp@glyphs-mcp, then reload the desktop client and check its tool catalog. Matching files do not prove an existing chat reloaded them.