Specsight runs an MCP server, so the AI assistant you already use can answer from your product knowledge. Ask Claude how a feature behaves and it answers from Specsight instead of guessing.
To ask inside Specsight instead, use Ask Specsight.
Connect an AI assistant
Open Integrations → MCP and follow the steps for your tool. You sign in with your Specsight account. There is no key to copy.
- Claude — click Connect to Claude, then Add in Claude, and sign in. It works on the web and in the desktop app
- ChatGPT — click Open ChatGPT, add Specsight as a custom MCP server, then sign in
- Claude Code — one terminal command, then sign in
- Codex — one terminal command, then sign in
Once you’re connected, the page gives you a first question to paste into your assistant.
API keys
Most people do not need one: the connectors above sign in with your Specsight account. Create a key only for a tool that cannot sign in, such as a script. A key stops working when the member who made it leaves your organisation.
- Open Integrations → MCP
- In API keys, click Create API key
- Name it, 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 do
Your assistant discovers the tools automatically. Fifteen read your spec, one drafts release notes and one sends feedback to the Specsight team. It cannot publish, create projects, edit scenarios, invite members or change billing.
| Tool | What it does |
|---|---|
| specsight_list_projects | List the projects in your organisation, each with a link into Specsight |
| specsight_get_project_summary | A project’s overview: what it is and its feature tree |
| specsight_get_feature | How one feature works: summary, scenarios, user flow and connections |
| specsight_get_scenario | One scenario by its reference (HP-23), with its history and team notes |
| specsight_search_scenarios | Search a project’s scenarios: every word must match, best matches first |
| specsight_list_releases | What shipped over a period, release by release |
| specsight_get_release | One release in full, found by its title, its day or its reference |
| specsight_get_changelog | What changed scenario by scenario, by period, feature, release or Highlights |
| specsight_get_release_notes | Release notes: published ones in full, or any one in full by its id |
| specsight_get_digests | Digests, the content of ready ones in full |
| specsight_get_feature_connections | How the product’s features connect |
| specsight_get_annotations | The team’s notes with their authors, by scenario, feature or words |
| specsight_get_help | Help articles about using Specsight |
| specsight_show_flow | Shows a feature’s user-flow diagram in the chat, drawn as Specsight draws it |
| specsight_show_release | Shows one release in the chat, as its page in Specsight opens |
| specsight_draft_release_notes | Drafts release notes for a period or one release, for you to edit and publish in Specsight |
| specsight_send_feedback | Sends the Specsight team a bug report, an idea or a question |
Your assistant also tells the Specsight team on its own when a tool fails or you say something isn’t working. If you’d rather it didn’t, tell it. Every report shows under Your feedback in your account.
Ready-made requests
Pick one instead of typing a question. Assistants that support them list them in a menu, and in Claude Code you type /mcp__specsight__ to see them.
- Tour of my product — what your product does, and the flow of its main feature
- What shipped this week — what changed, the most important for customers first
- Today's changes — what changed today, a good one to put on a daily schedule
- Explain a feature — how one feature works, step by step, with its flow
- Draft release notes — a draft for a period, to edit and publish in Specsight
Limits
- Rate limit — 100 requests a minute per key or OAuth sign-in
- Search results — 50 per call
- Drafting — needs a role that can draft (members and roles) and counts toward your 50 drafts a month on the Standard plan. A tool connected before drafting existed only reads until you reconnect it