Prerequisites
- VS Code or Cursor installed. The Python verification example also requires Python 3.
- An active Step Plan subscription with available quota and access to the selected model.
- An API key from the StepFun platform API keys page.
Install Cline
Find Cline in your editor’s extension marketplace and install it. The extension ID issaoudrizwan.claude-dev.
Configure Step Plan
Select the provider
- Open the Cline panel and select
API Configurationin settings. On first launch, selectConfigure your provider. - Select
StepFun Step Plan (Global)underAPI Provider. - Enter your API key and select
step-5-preview. Check the remaining connection settings below.
If your version does not include a Step Plan preset, select
OpenAI Compatible and enter the same base URL, API key, and model ID. Cline appends /chat/completions, producing /step_plan/v1/chat/completions.
Check model settings
ExpandMODEL CONFIGURATION. These settings apply to Step 5 Preview. When using a preset, check its existing values.
When switching models, match the context window and output budget to the selected model. Save the settings and start a new task.
Connect StepSearch MCP
StepSearch providesweb_search and web_fetch through the Step Plan endpoint. Add it when you need web searches or page retrieval.
- Open
MCP Serversin the Cline panel, selectConfigure, then chooseConfigure MCP Servers. - Merge the following configuration into
cline_mcp_settings.json, preserving other servers. ReplaceYOUR_STEP_API_KEYwith your key:
- Save the file. Confirm that
step-searchis connected and its tool list includesweb_searchandweb_fetch. - Start a new task and ask Cline to use either tool. Inspect the tool call and returned result.
streamableHttp spelling for type. Omitting it selects the legacy SSE transport. With autoApprove: [], approve tool calls when prompted.
Verify the integration
Test a conversation
Start a new task and enterReply only with OK. Expected output: OK.
Test tool calls
- Create a separate test directory with a
README.mdcontainingCline Step Plan test, then open it in the editor. - Select
Actmode in Cline and enter:
- Approve the required file operations and commands. Inspect the tool records, confirm that
hello.pyexists and printsHello, world!, and check thatREADME.mdis unchanged.
Check saved settings
Restart the editor, confirm that the provider and model selection are retained, and start another short conversation.Common questions
Q: What if the Step Plan provider is missing?
Q: What if the Step Plan provider is missing?
Update Cline, or select
OpenAI Compatible with https://api.stepfun.ai/step_plan/v1, your API key, and step-5-preview or another model available to your account.Q: What should I check after a Connection error?
Q: What should I check after a Connection error?
Check the base URL, network connection, API key, and model permissions. The base URL ends at
/step_plan/v1; do not add Bearer to the API Key field. Use the full error to distinguish authentication, model, and request-parameter failures. A successful model-list request still needs a conversation test.Q: What should I check after a 401 response?
Q: What should I check after a 401 response?
Confirm that the key is complete, valid, and free of leading or trailing spaces, and belongs to the account for this endpoint. Enter the raw key in the model connection settings. The MCP header instead requires
Authorization: Bearer YOUR_STEP_API_KEY.Q: Why does Cline reply without editing files or running commands?
Q: Why does Cline reply without editing files or running commands?
Select
Act mode and open the target project. Check for pending tool approvals and approve the required operations. You do not need to enable all auto-approval options. Start a new task if you have just changed the configuration.Q: Why is the response empty, truncated, or missing visible text during reasoning?
Q: Why is the response empty, truncated, or missing visible text during reasoning?
Reasoning may produce no visible text until it completes. If the request finishes without text, inspect the stop reason, errors, and output budget. A small budget may be exhausted before visible output begins. For Step 5 Preview, check the model settings above before adjusting them based on the error.
Q: Why is step-search or its tool list missing?
Q: Why is step-search or its tool list missing?
Check that the configuration is under
mcpServers, type is streamableHttp, disabled is false, and the authorization header contains the Bearer prefix and complete key. Save, reconnect the server, and inspect its connection log.
