Skip to main content
Cline is a coding agent for editors such as VS Code and Cursor, with Plan and Act modes, file editing, and terminal command execution. Its Step Plan provider connects the editor to Step models.

Prerequisites

Install Cline

Find Cline in your editor’s extension marketplace and install it. The extension ID is saoudrizwan.claude-dev.

Configure Step Plan

Select the provider

  1. Open the Cline panel and select API Configuration in settings. On first launch, select Configure your provider.
  2. Select StepFun Step Plan (Global) under API Provider.
  3. 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

Expand MODEL 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 provides web_search and web_fetch through the Step Plan endpoint. Add it when you need web searches or page retrieval.
  1. Open MCP Servers in the Cline panel, select Configure, then choose Configure MCP Servers.
  2. Merge the following configuration into cline_mcp_settings.json, preserving other servers. Replace YOUR_STEP_API_KEY with your key:
  1. Save the file. Confirm that step-search is connected and its tool list includes web_search and web_fetch.
  2. Start a new task and ask Cline to use either tool. Inspect the tool call and returned result.
Use Cline’s exact streamableHttp spelling for type. Omitting it selects the legacy SSE transport. With autoApprove: [], approve tool calls when prompted.
The MCP configuration stores the API key in plain text. Keep it in Cline’s user configuration and do not commit or share the key. Anyone with the key may make requests using your permissions and consume quota.

Verify the integration

Test a conversation

Start a new task and enter Reply only with OK. Expected output: OK.

Test tool calls

  1. Create a separate test directory with a README.md containing Cline Step Plan test, then open it in the editor.
  2. Select Act mode in Cline and enter:
  1. Approve the required file operations and commands. Inspect the tool records, confirm that hello.py exists and prints Hello, world!, and check that README.md is unchanged.
Auto-approval is optional. Manual approval is sufficient for this test.

Check saved settings

Restart the editor, confirm that the provider and model selection are retained, and start another short conversation.

Common questions

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