Skip to Content
REST APIMCP Server

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.io

How 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.io

Then 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

ToolDescription
list_templatesList templates (with search by name)
get_templateGet template details and sections
create_templateCreate a new template
update_templateEdit an unpublished template
publish_templatePublish or unpublish a template
delete_templateDelete an unpublished template

Template tasks

ToolDescription
list_template_tasksList tasks in a template
create_template_taskAdd a task with form fields
update_template_taskEdit a task in an unpublished template
delete_template_taskRemove a task

Process runs

ToolDescription
list_runsList runs with progress (filter by template, status, or assignee)
get_runGet run details with full task list
create_runStart a run from a published template
update_runRename or change due date
delete_runDelete a run

Run tasks

ToolDescription
list_run_tasksList tasks with completion status
get_run_taskGet task details including form fields
complete_taskComplete or uncomplete a task
assign_taskAssign a team member
update_task_fieldsFill in form fields without completing

Scheduling

ToolDescription
list_scheduled_runsView recurring schedules
create_scheduled_runSet up a recurring run
delete_scheduled_runRemove a schedule

Team & collaboration

ToolDescription
list_team_membersSee team members for assignments
list_commentsView task comments
add_commentAdd a comment
get_schemaGet 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 nextstep

Claude Desktop

Remove the nextstep entry from claude_desktop_config.json and restart.

Troubleshooting

ProblemWhat 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 homepageClear cookies for getnextstep.io and try again.
”db is not defined” or other server errorsA temporary server-side issue — try again in a minute. If it persists, contact support.
Tools missing or not showingDisconnect 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 errorYour MCP client doesn’t support PKCE. Update to a recent version.

Limits

LimitValue
All tool calls100 per minute per user
Write operations30 per minute per user
Access token lifetime1 hour
Refresh token lifetime90 days

Need help?

Last updated on