Specsight runs a read-only MCP server so AI assistants can read your features, scenarios, and changelog directly. Ask Claude or ChatGPT how a feature behaves and it queries your live spec instead of guessing.
Everything you need is in one place. Open the dashboard, go to Integrations → MCP, and follow the steps for your tool.
Connect an AI assistant
On the MCP page, the Connect your AI assistant section has step-by-step guides. Pick your tool and the steps update for it. You sign in with your Specsight account — no key to copy.
- Claude — add Specsight as a custom connector at claude.ai
- ChatGPT — add as a developer-mode MCP connector
- Claude Desktop — add via the desktop app connector settings
- Claude Code — one terminal command, then sign in
API keys
Most users do not need an API key — the connectors above sign in with OAuth. Create a key only when your tool does not support OAuth (Cursor, Windsurf, custom scripts) or when you want to share one across a team.
- Go to Integrations → MCP
- In the API keys section, click Create API key
- Give it a name (for example "Cursor, work laptop") and click Create key
- Copy the key — it starts with sk_sp_ and is shown once. Paste it into your tool as a Bearer token in the Authorization header
What the assistant can read
Specsight exposes eight read-only tools. Your assistant discovers them automatically once connected.
| Tool | What it does |
|---|---|
| specsight_list_projects | List every project in the organisation |
| specsight_get_project_summary | Project overview with feature tree and scenario counts |
| specsight_list_features | Hierarchical feature list |
| specsight_get_scenarios | All Context, Action, Outcome scenarios for a feature |
| specsight_search_scenarios | Keyword search across a project |
| specsight_get_changelog | Recent changes with before-and-after diffs |
| specsight_get_feature_connections | Feature relationships from the flow diagram |
| specsight_get_help | Help articles about using Specsight |
Read-only means it. The assistant cannot create projects, edit scenarios, invite members, or change billing. Everything in the dashboard stays yours alone to change.
Limits
- Rate limit — 100 requests per minute per key or OAuth sign-in
- Search results — capped at 50 per call
- Scope — every key is organisation-wide and read-only