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.
This is the outside-in route: your own AI assistant reads the spec from wherever you work. To chat with Specsight inside the dashboard instead, use Ask Specsight.
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