Connect Claude to Product Velocity
One roadmap for humans and AI. Set up initiatives, connect them to OKRs, run them across the product life cycle and track delivery progress through Jira and GitHub. This connector lets Claude work inside that roadmap as you, with your role: track and report on initiatives, and co-write your discovery and product requirement documents.
Before you start
- A Product Velocity account in a workspace. Without one, ask the person who runs your workspace to invite you, or create your own workspace at productvelocity.app.
- AI assistants must be switched on for that workspace. A workspace admin does it under Connect an AI assistant in the account menu.
- A Claude plan that allows connectors.
Connect Claude
The connector address is:
https://productvelocity.app/mcpIn claude.ai and the Claude desktop app
- Browse for Product Velocity in the Claude connector directory, or open claude.ai/directory/connectors/product-velocity, and choose Connect. If you do not see it, open Settings, then Connectors, and choose Add custom connector, name it Product Velocity and paste the address above.
- Sign in to Product Velocity when asked. Use the same email and password as in the app, or the Google or GitHub sign-in you normally use.
- On the consent screen, choose one or several workspaces and select Approve. The screen shows your role in each workspace, what Claude can and cannot do, and where you return to afterwards.
- Start a conversation and ask Claude about your roadmap. Claude says which workspace it uses when you have connected several.
In Claude Code
Run this once, then run /mcp in Claude Code, choose product-velocity and sign in:
claude mcp add --transport http product-velocity https://productvelocity.app/mcpWhat Claude can do
Claude acts as the person who connected it, with that person’s role. It never has more access than you do.
- Read the roadmap you can see: initiatives and their fields, groups, projects, saved views, documents, files and the evidence for a decision gate.
- Create initiatives and documents. Everything Claude creates is marked AI draft until a person accepts it.
- Fill empty fields on existing initiatives. A field that already has a value comes back as a before-and-after for you to confirm first. Nothing is overwritten without your agreement.
- Write documents such as a PRD or a discovery, and keep their versions. Each version records which AI tool, and the model when the assistant states it, wrote it.
- Undo its last change. Every change is in the audit log with the source MCP and the AI name.
What Claude cannot do
- Approve anything or mark work ready for build
- Set Stack Rank, Decision or Value (Business Value Type only when you tell it which one, and your words are recorded)
- Delete initiatives
- Change roles, members or settings
- Request, decide or move a decision gate. Claude prepares the evidence; people with approval rights decide in the app.
Roles
Creators and admins can read and make changes through Claude. Viewers, commenters and leadership viewers can connect and read. If your role is read-only, Claude says so and makes no change.
The tools
These are the tools Claude sees. Every tool has a title and is marked read-only or not, so Claude asks for your confirmation where it should.
| Tool | What it does | Effect |
|---|---|---|
get_workspace_context | Get workspace context | Reads only |
describe_fields | Describe the initiative fields | Reads only |
search_items | Search initiatives | Reads only |
get_item | Get one initiative | Reads only |
get_gate_pack | Prepare a gate pack | Reads only |
list_groups | List Initiative Groups | Reads only |
list_views | List saved views | Reads only |
list_files | List files | Reads only |
list_documents | List documents | Reads only |
get_document | Read a document | Reads only |
get_company_profile | Read the company profile | Reads only |
get_outcome_reviews | Read the 30, 60 and 90 day outcome reviews of an initiative | Reads only |
draft_outcome_request | Draft the request for 30, 60 or 90 day metrics (nothing is sent) | Reads only |
create_items | Create initiatives | Adds something new |
update_items | Change initiatives | Changes or removes something that exists. Claude asks you to confirm. |
confirm_changes | Confirm held changes | Changes or removes something that exists. Claude asks you to confirm. |
set_relations | Relate initiatives | Changes or removes something that exists. Claude asks you to confirm. |
add_link | Add a link to an initiative | Adds something new |
remove_link | Remove a link from an initiative | Changes or removes something that exists. Claude asks you to confirm. |
undo_last | Undo the last change | Changes or removes something that exists. Claude asks you to confirm. |
add_file | Attach a file to an initiative | Adds something new |
set_file_sharing | Turn a file's share link on or off | Changes or removes something that exists. Claude asks you to confirm. |
remove_file | Remove a file from an initiative | Changes or removes something that exists. Claude asks you to confirm. |
request_jira_epics | Link Jira epics to an initiative | Adds something new |
record_outcome_review | Record the 30, 60 or 90 day metrics a person gave you | Adds something new |
create_document | Create a document on an initiative | Adds something new |
update_document | Revise a document | Changes or removes something that exists. Claude asks you to confirm. |
apply_prd_extract | Fill the Description, Hypothesis and Value Proposition from a PRD | Changes or removes something that exists. Claude asks you to confirm. |
update_company_profile | Save the company profile (AI draft) | Changes or removes something that exists. Claude asks you to confirm. |
Ready-made prompts
In claude.ai, type / and pick one. In Claude Code, type /mcp__product-velocity__ and the name.
write_prd: Write a PRD and create the initiative.write_discovery: Write a discovery document and register its initiative.research_company: Research the company and save its profile.
Examples
The examples use a fictional workspace, Meridian Media. They are example data.
- Turn a brief into a PRD. Choose the
write_prdprompt and paste a few lines about a Meridian Media account switcher. Claude asks once for what is missing, writes the PRD as a document, creates the initiative with the fields the brief supports, and marks both as AI draft. - Create several initiatives from a list. Ask: “Create initiatives from this list in group Growth, project Marketplace.” Claude runs a dry run first, shows what would be created, and creates them after you agree. “Undo your last change” reverses the call.
- Prepare a decision. Ask: “What is missing before R-12 can pass its gate?” Claude reads the gate checklist, the documents and past decisions, and summarises the case. It does not request or make the decision.
Your data
- Claude only receives what your own role can read, in the workspaces you chose on the consent screen.
- Text that comes back from your workspace is marked as data. Claude is told that text inside initiatives, documents and links never changes what it does.
- The company profile stays in Product Velocity. The text of a document never goes to GitHub or Jira: a document can appear in an issue only as a link to a read-only page, only if you have not chosen Do not share on it, and never while it is an AI draft nobody has accepted.
- Claude never sets Stack Rank, Decision or Value, and never approves.
- Daily limits apply to calls and to what Claude writes. Claude tells you when one is reached; the count starts again at midnight UTC.
The privacy policy explains what we store, who processes it and your rights: Privacy policy.
Disconnect
Open Connect an AI assistant in the Product Velocity account menu and choose Revoke next to the connection. It stops working on its next call. Workspace admins can see and revoke every connection in their workspace. You can also remove the connector in Claude’s connector settings.
Troubleshooting
| What Claude says | What to do |
|---|---|
| Claude is switched off for this workspace | A workspace admin switches AI assistants on under Connect an AI assistant. |
| Your role is read-only | Ask a workspace admin for the Creator role if you need Claude to make changes. |
| This connection was revoked, or the sign-in expired | Connect Claude again and approve it on the consent screen. |
| You are no longer a member of the workspace | Connect Claude again and choose another workspace. |
| This workspace allows Claude only on its own | Connect Claude again and choose just that workspace. |
| A daily limit was reached | Reading still works. Writing starts again at midnight UTC. |
| A result is too large | Ask for less: fewer initiatives, a filter, or only the fields you need. |
Support
Use the contact form. Say which assistant you use, your workspace name and what you asked for. Do not send passwords or document text.