MCP Server
Connect Claude or any MCP-compatible AI assistant to NextStep. Ask your assistant to manage processes in plain English — create templates, start runs, complete tasks, schedule recurring work, and more.
MCP Server URL:
https://mcp.getnextstep.ioHow it works
Add the connector
Paste the URL above into your AI client (Claude.ai, Claude Code, etc.).
Sign in to NextStep
You’ll be redirected to a NextStep login page. Sign in with your usual credentials (email/password, Google, or Microsoft).
Start asking questions
Your assistant now has access to your team’s templates, runs, and tasks — everything you can see in NextStep, your AI can see.
Stay in control
Every action goes through your NextStep account. Claude will ask you to confirm before making changes.
What is MCP?
MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools and data. Once connected, your assistant has access to 27 tools for managing your processes — listing templates, creating runs, completing tasks, and more.
Connecting
Claude.ai
Open Connectors
Go to Settings → Connectors → Add Custom Connector.
Enter the details
- Name: NextStep
- URL:
https://mcp.getnextstep.io - Leave OAuth Client ID and Secret empty
Authorize
Click Add, then sign in with your NextStep account when prompted.
Claude Code (CLI)
claude mcp add --transport http nextstep https://mcp.getnextstep.ioThen run any command — Claude will prompt you to authenticate on first use.
Claude Desktop
Edit claude_desktop_config.json:
{
"mcpServers": {
"nextstep": {
"url": "https://mcp.getnextstep.io"
}
}
}Restart Claude Desktop after saving.
Other MCP Clients
Any client that supports Streamable HTTP transport and OAuth 2.1 with PKCE can connect. Use the URL above as the server endpoint.
Example prompts
Onboarding & HR
- “Start the new hire onboarding for alice@company.com”
- “Who’s on my team?”
- “Show me all tasks assigned to bob@company.com across active runs”
- “Create an offboarding process with sections for IT, HR, and Finance”
Operations & Recurring work
- “Schedule the weekly standup process every Monday at 9am”
- “Show me my recurring schedules and which ones are active”
- “Cancel the monthly compliance check schedule”
Daily task management
- “What’s overdue right now?”
- “Show me all active runs and their progress”
- “Mark the background check task complete on Alice’s onboarding”
- “Reassign the contract review task to legal@company.com”
Template creation
- “Create a customer onboarding template based on these requirements: …”
- “Add a ‘Manager approval’ task to the offboarding template”
- “Find my templates that mention ‘invoice‘“
Status & reporting
- “Summarise the status of all active runs”
- “Which runs have someone stuck on a task for more than a week?”
- “Show me comments on the latest contract review run”
Available tools
Templates
| Tool | Description |
|---|---|
list_templates | List templates (with search by name) |
get_template | Get template details and sections |
create_template | Create a new template |
update_template | Edit an unpublished template |
publish_template | Publish or unpublish a template |
delete_template | Delete an unpublished template |
Template tasks
| Tool | Description |
|---|---|
list_template_tasks | List tasks in a template |
create_template_task | Add a task with form fields |
update_template_task | Edit a task in an unpublished template |
delete_template_task | Remove a task |
Process runs
| Tool | Description |
|---|---|
list_runs | List runs with progress (filter by template, status, or assignee) |
get_run | Get run details with full task list |
create_run | Start a run from a published template |
update_run | Rename or change due date |
delete_run | Delete a run |
Run tasks
| Tool | Description |
|---|---|
list_run_tasks | List tasks with completion status |
get_run_task | Get task details including form fields |
complete_task | Complete or uncomplete a task |
assign_task | Assign a team member |
update_task_fields | Fill in form fields without completing |
Scheduling
| Tool | Description |
|---|---|
list_scheduled_runs | View recurring schedules |
create_scheduled_run | Set up a recurring run |
delete_scheduled_run | Remove a schedule |
Team & collaboration
| Tool | Description |
|---|---|
list_team_members | See team members for assignments |
list_comments | View task comments |
add_comment | Add a comment |
get_schema | Get the data model for creating templates and tasks |
Privacy & security
Your NextStep data flows through Claude (an Anthropic product) when you use this integration. See Anthropic’s privacy policy for how they handle your data.
What your AI can see:
- Only your team’s data — exactly what you’d see when logged into NextStep
- Limited by your role and permissions in NextStep
What your AI cannot do:
- Access other teams’ data
- Bypass NextStep permissions
- Delete published templates (you must unpublish first)
- Modify billing or team settings
How auth works:
- OAuth 2.1 + PKCE — your AI never sees your password
- Access tokens expire after 1 hour
- All traffic is encrypted (HTTPS/TLS)
- Cancelling your subscription revokes MCP access immediately on next token refresh
Disconnecting
Claude.ai
Settings → Connectors → NextStep → Disconnect
Claude Code
claude mcp remove nextstepClaude Desktop
Remove the nextstep entry from claude_desktop_config.json and restart.
Troubleshooting
| Problem | What to try |
|---|---|
| ”Couldn’t reach the MCP server” | Verify the URL is exactly https://mcp.getnextstep.io with no trailing slash. Check your internet connection. |
| ”An active subscription is required” | MCP needs a paid plan. Check your billing or upgrade. |
| ”You are not an active member of this team” | Your team membership may have been revoked. Ask your team admin to re-add you. |
| Login page redirects to homepage | Clear cookies for getnextstep.io and try again. |
| ”db is not defined” or other server errors | A temporary server-side issue — try again in a minute. If it persists, contact support. |
| Tools missing or not showing | Disconnect and reconnect the connector. For Claude Desktop, restart the app. |
| Rate limited (HTTP 429) | You’ve exceeded 100 calls/minute (or 30 write calls/minute). Wait a minute and retry. |
| PKCE error | Your MCP client doesn’t support PKCE. Update to a recent version. |
Limits
| Limit | Value |
|---|---|
| All tool calls | 100 per minute per user |
| Write operations | 30 per minute per user |
| Access token lifetime | 1 hour |
| Refresh token lifetime | 90 days |
Need help?
- MCP issues / questions about tools: hello@getnextstep.io
- NextStep account issues: hello@getnextstep.io
- Claude.ai issues: support.anthropic.com
- Claude Code issues: github.com/anthropics/claude-code/issues