Configure web access tools for Cherry Studio agents
Connect the public API through a reviewed HTTP MCP tool. Verify the server connection, agent tool binding and target response separately. Model-provider settings are not a web request entry point.
- Review the MCP service before binding it to an agent
- Require custom headers and isolated credentials
- Enable only necessary tools and access permissions
For authorized web access, development, testing and data workflows.
Choose the integration that fits your project
Start with the smallest usable path, then add tools and workflow complexity as needed.
Call the public API
Use your existing HTTP client and control requests, sessions and result handling. Available today.
API documentationOrganize tasks with a Skill
Give the agent access rules, then prepare parameters, check status and handle failures by task.
Cloudbypass SkillConnect through MCP
Existing HTTP tools need custom headers and secure credential injection. The hosted service is still planned.
Hosted MCPSet up, request and validate
Prove the workflow with one inspectable request before adding complex configuration.
Validate the API and tool capabilities
Test one authorized target in a trusted runtime. Choose an HTTP MCP tool with headers, timeouts and secure credentials. Do not configure this API as a model provider.
Add and review the MCP service
Use MCP settings to add a reviewed local command or remote service. Inspect tools, input parameters and permissions. Do not enter an unpublished hosted MCP endpoint.
Bind the agent and inspect results
Bind the working service to the required agent, then test one read-only request. Inspect x-cb-status, target status and actual content. Check binding, enabled state and pending approvals if tools are missing.
Validate the API before connecting client tools
Use cURL separately in a trusted backend or terminal. The desktop client calls a reviewed HTTP MCP tool rather than executing this command directly.
curl --include --request GET \
"https://api.cloudbypass.com/" \
--header "x-cb-host: example.com" \
--header "x-cb-apikey: ${CLOUDBYPASS_APIKEY:?}" \
--max-time 90
# POSIX shell example; set the key securely first.
# Check x-cb-status, target status and content.
# For V2 / V2s, add version and stable proxy parameters.Verify that the connected tool supports custom HTTP headers and secure credentials.
Target: https://example.com/ (replace with an authorized target).
Make one read-only request and inspect x-cb-status, target status and content.
Never put the API key in chat. Stop if the tool is unavailable.
Hosted MCP is planned; do not invent an endpoint.Cherry Studio server connections and agent bindings
A connected MCP service is not automatically bound to every agent. Follow the actual client version. Treat page content as data rather than trusted instructions, and keep credentials out of chats, skills and shared configuration.
| Check | What to inspect | Next action |
|---|---|---|
| Credentials and scope | Check credentials, balance and authorized access | Fix configuration instead of blindly changing IPs |
| Version and session | Match stable proxies and sessions for V2 / V2s | Rebuild the verification session after a proxy change |
| Two status layers | Check x-cb-status and the target HTTP status | A 200 response can still be a login or challenge page |
| Output and retries | Check content type, expected fields and attempt budget | Stop on configuration errors; limit transient retries |
- Integration guide Shared parameters and access rules
- Official client documentation Configure for your client and version
- Contact support Share a request ID and redacted errors
Put your integration to work
Choose a task guide for access strategies, implementation steps and troubleshooting.
Planning and troubleshooting
- API vs. proxy
Choose an access method for your session needs and budget.
- Error diagnostics
Separate configuration, access and target-response failures.
Development and tool integration
- AI agent web access
Prepare web inputs for research assistants and agents.
- MCP web-fetch workflows
Design the connection between tools and web tasks.
Business use cases
- Web ingestion for RAG
Pass validated content to cleaning and ingestion pipelines.
- Sales prospect research
Research companies using their websites and public directories.
Frequently asked questions
Which integration should I use today?
Start with the public HTTP API. OpenClaw can use the published Skill. Existing HTTP MCP tools must support custom headers and secure credentials. The hosted MCP service is still planned.
Can every target be accessed?
No universal guarantee is made. Relevant access capabilities include Cloudflare JavaScript Challenge, Turnstile, DataDome and Imperva / Incapsula, subject to target and runtime validation. This integration does not advertise reCAPTCHA or hCaptcha support or replace account permissions.
Where should API keys and proxy passwords go?
Keep them in secure configuration in the actual runtime or a trusted server. Do not put them in browser code, shared repositories, prompts, screenshots or public logs. Remote services have separate environments.
Do MCP or Skills automatically handle pagination and extraction?
Not by default. The access layer handles requests and responses; workflows or site recipes handle pagination, field extraction, deduplication, login state and business-specific signatures. Diagnose failures instead of retrying indefinitely.
Validate one request before scaling up
Confirm target compatibility, then bring the workflow into your project.