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

Connect Claude

The connector address is:

https://productvelocity.app/mcp

In claude.ai and the Claude desktop app

  1. 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.
  2. 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.
  3. 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.
  4. 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/mcp

What Claude can do

Claude acts as the person who connected it, with that person’s role. It never has more access than you do.

What Claude cannot do

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.

ToolWhat it doesEffect
get_workspace_contextGet workspace contextReads only
describe_fieldsDescribe the initiative fieldsReads only
search_itemsSearch initiativesReads only
get_itemGet one initiativeReads only
get_gate_packPrepare a gate packReads only
list_groupsList Initiative GroupsReads only
list_viewsList saved viewsReads only
list_filesList filesReads only
list_documentsList documentsReads only
get_documentRead a documentReads only
get_company_profileRead the company profileReads only
get_outcome_reviewsRead the 30, 60 and 90 day outcome reviews of an initiativeReads only
draft_outcome_requestDraft the request for 30, 60 or 90 day metrics (nothing is sent)Reads only
create_itemsCreate initiativesAdds something new
update_itemsChange initiativesChanges or removes something that exists. Claude asks you to confirm.
confirm_changesConfirm held changesChanges or removes something that exists. Claude asks you to confirm.
set_relationsRelate initiativesChanges or removes something that exists. Claude asks you to confirm.
add_linkAdd a link to an initiativeAdds something new
remove_linkRemove a link from an initiativeChanges or removes something that exists. Claude asks you to confirm.
undo_lastUndo the last changeChanges or removes something that exists. Claude asks you to confirm.
add_fileAttach a file to an initiativeAdds something new
set_file_sharingTurn a file's share link on or offChanges or removes something that exists. Claude asks you to confirm.
remove_fileRemove a file from an initiativeChanges or removes something that exists. Claude asks you to confirm.
request_jira_epicsLink Jira epics to an initiativeAdds something new
record_outcome_reviewRecord the 30, 60 or 90 day metrics a person gave youAdds something new
create_documentCreate a document on an initiativeAdds something new
update_documentRevise a documentChanges or removes something that exists. Claude asks you to confirm.
apply_prd_extractFill the Description, Hypothesis and Value Proposition from a PRDChanges or removes something that exists. Claude asks you to confirm.
update_company_profileSave 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.

Examples

The examples use a fictional workspace, Meridian Media. They are example data.

  1. Turn a brief into a PRD. Choose the write_prd prompt 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.
  2. 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.
  3. 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

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 saysWhat to do
Claude is switched off for this workspaceA workspace admin switches AI assistants on under Connect an AI assistant.
Your role is read-onlyAsk a workspace admin for the Creator role if you need Claude to make changes.
This connection was revoked, or the sign-in expiredConnect Claude again and approve it on the consent screen.
You are no longer a member of the workspaceConnect Claude again and choose another workspace.
This workspace allows Claude only on its ownConnect Claude again and choose just that workspace.
A daily limit was reachedReading still works. Writing starts again at midnight UTC.
A result is too largeAsk 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.