Claude (claude.ai and Claude Desktop)
Add SpecsGraph to Claude as a custom connector, sign in and allow it, then read your spec and stage changes from claude.ai and Claude Desktop.
The SpecsGraph connector lets Claude read the spec of your projects, follow workstreams, tasks and review threads, ask your team questions and stage spec changes for people to accept. It connects to the SpecsGraph MCP server and signs in with your SpecsGraph account; there is no token to create.
Before you start
- A Claude plan that supports custom connectors. On Team and Enterprise plans, an owner may need to add the connector for the organization first.
- A SpecsGraph account in an organisation, with the Editor role or above if the agent should stage changes. A Viewer's agent reads, comments and asks questions.
- The SpecsGraph MCP URL,
https://mcp.specsgraph.io/mcp; see The MCP URL.
Add the connector
Open the connector settings
In claude.ai or Claude Desktop, open Customize, then Connectors, and choose Add custom connector.
Enter the name and URL
Name it SpecsGraph and paste the server URL. Leave the advanced OAuth fields empty: Claude registers itself with SpecsGraph.
Text Name: SpecsGraph Remote MCP server URL: https://mcp.specsgraph.io/mcpConnect and sign in
Choose Connect. Claude opens
app.specsgraph.ioin your browser. Sign in to SpecsGraph if you are not already.Allow the connector
The consent page asks "Allow Claude to use SpecsGraph?". Check that it returns to
claude.ai, then pick the organisation under Organisation, the expiry, the access (Read only, or Read and write to stage changes) and the projects. Choose Allow. The browser returns to Claude and the connector shows as connected.
Connectors you add in claude.ai are available in Claude Desktop with the same account, and the other way round. Turn the connector on for a conversation from the tools menu in the chat input.
Note
Claude's own help center is the authority on its settings screens and plans. The steps here reflect Claude at the time of writing.
What the connector can do
- Read. 16 tools read projects, spec documents, artefacts, workstreams and their changes, tasks, proposals and threads. They never change anything.
- Stage spec changes.
spec_applystages edited documents as revisions in the proposal of a workstream, grouped into plans withproposal_plan, one per task. A person accepts them into the workstream in the web app; Main changes only when a task publishes. - Plan and discuss. Tools that open and assign workstreams and tasks, start a Ready task, open or reply to comment threads and ask people questions with
thread_ask. - Pick up work.
work_item_next,work_item_claimandwork_item_updatetake a work item, keep the claim and record the pull request;build_statusandroadmap_getread what is built and what comes next. - With Agent autonomy on, Claude also writes the workstream directly, accepts, routes tasks, submits them as Ready and resolves threads.
- Never publish a task, record a verify or uat result, mark a work item done or edit the work items of a task, mark code as implemented, change the roadmap, or change project, organisation or account settings. Those stay in the web app; the server lists no tool for them.
Claude asks before it calls a tool unless you allow it, and you can change that per tool in the connector's settings. Read-only tools are safe to allow. Look at the arguments of the destructive tools, proposal_discard, workstream_abandon, workstream_discardChange and task_abandon, before you approve them.
Tools
The server also offers 4 prompts, such as read-then-propose, which Claude shows in the attachment menu when the connector is on. The MCP tool reference describes every tool and prompt with its inputs.
Example prompts
Disconnect and revoke
- In Claude. Open Customize, then Connectors, select SpecsGraph and disconnect or remove it. Claude stops calling the server.
- In SpecsGraph. Open Settings, then Access tokens, then Signed-in agents, choose Revoke next to Claude, then Revoke agent. The connector stops working at its next request. Do this too if you removed the connector in Claude, so no stored grant is left behind.
Data handling
- SpecsGraph receives the tool calls Claude makes and their arguments, not your conversation.
- Tools return content only from the organisation and projects you allowed on the consent page.
- What the connector writes (staged revisions, plans, threads, questions, tasks) is stored in your organisation and attributed to you through Claude, so reviewers can see where it came from.
- Claude handles your conversation under Anthropic's own terms and privacy policy.
The Privacy Policy covers what SpecsGraph stores and for how long, and Security and your data covers hosting and export.
Troubleshooting
Support
Email support@specsgraph.io for help with the connector, or see Support for every way to reach us. Include the time of the problem and the tool name if you have it.