Connect Cursor to Semogram

Use Cursor to inspect your Semogram workspace from the conversation where you already work. For example, compare a delivery summary with its underlying orders and receipts, or inspect a published workflow before deciding to run it.

The steps below follow the client’s documented MCP setup. This client connection has not yet been verified end to end against Semogram; complete the first-read checks below to verify your workspace access.

Install

Before you start

You need a Semogram account with access to a workspace, an installed client with MCP tools enabled, and a model that can call tools. Your organization may control which external servers and assistant providers you can use.

In Semogram, open workspace Settings → Connect an AI assistant and copy the workspace MCP URL. Its form is:

https://platform.semogram.com/api/mcp/workspaces/<WORKSPACE_ID>

Use the copied URL wherever the example says <YOUR_WORKSPACE_MCP_URL>. A workspace name cannot replace its UUID. The URL identifies the workspace and does not grant access by itself. Connecting an assistant does not import records or create a project; connect your data if there is nothing to inspect yet.

Add the connection and sign in

Open your personal ~/.cursor/mcp.json, or create .cursor/mcp.json in the repository when the workspace connection should be shared with that team. Merge this entry into the existing mcpServers object:

{
  "mcpServers": {
    "semogram": {
      "url": "<YOUR_WORKSPACE_MCP_URL>"
    }
  }
}

Save and restart Cursor. Open its MCP settings and enable semogram. Follow the OAuth prompt, sign into Semogram with your workspace account, and approve the connection. The configuration contains an address, not a credential; teammates sign in separately. Use Agent chat and check that the Semogram tools are enabled.

Make your first read

In Agent chat, start with a read-only request:

Use Semogram to discover the available capabilities, confirm the workspace name and ID, and list the projects I can access. Do not change anything.

The assistant should call discover_capabilities, workspace_get, and project_list. Compare the returned workspace with the one you intended and choose a project. Workspace-scoped resources do not take a projectId; project operations on this workspace connection do.

Then use a record or query that actually exists in that project:

Inspect our published delivery summary query. Explain its inputs, show its latest run, and identify the order and receipt records behind the result. If it does not exist, say so rather than creating a replacement.

Replace the example query name with yours. Inspect the tool calls and returned references, rather than accepting a conversational answer as proof of access. A tool list confirms discovery, not that your data is complete or the answer is correct. Read a run to inspect the result.

Manage the connection

Inspect the MCP entry in Cursor settings. To disconnect, disable it or remove only the semogram entry from the matching JSON file. For failures, open the Output panel and select MCP Logs. Check whether you edited the personal or project file; a project entry with the same name takes precedence.

Removing a client configuration does not delete Semogram data. Each additional workspace should have its own clearly named connection and its own copied URL.

FAQ

What permissions does the assistant have?

An OAuth connection uses the signed-in account’s current workspace permissions. A missing project or tool can reflect those permissions. An assistant approval prompt does not replace Semogram’s server-side operation approvals.

Ask to inspect drafts before executing workflows or changing records. Keep the returned job or operation ID when work runs asynchronously and check its final status. Data returned to the client is handled by its assistant provider; use your organization’s approved account and data-sharing policy.

Source-write tools have additional API-key requirements described in the MCP reference. They are not enabled simply by reconnecting an OAuth client.

Why is the connection failing?

For client-specific failures, inspect MCP Logs. Before sharing logs, remove tokens, private records, and personal information. See MCP troubleshooting for server error details.

Where can I learn more?

Return to choose your assistant, review tools and scopes, or consult the official Cursor MCP documentation for controls that vary by version.