CONNECTOR GUIDE
Run a mission. Inspect the result.
Black Label Operator connects Claude and other MCP clients to your isolated hosted workspace. Run a bounded Claude Code or Codex mission and retrieve its status, artifacts, and receipts.
Before connecting
- Create or sign in to your Operator account and check its trial or subscription status.
- Authorize the provider you intend to use in your own workspace. Provider access uses your eligible Claude or ChatGPT subscription. Operator does not supply a provider subscription.
- Use repositories, accounts, and material you are authorized to process. Keep credentials out of mission text.
Connect your client
- Open your AI client's custom connector settings and add
https://operator.blacklabelbots.com/mcp. - Complete Operator's sign-in and authorization flow. Review the requested permissions.
- Ask for your Operator status. Confirm the workspace and selected provider are ready.
The public website-information endpoint at /agent/mcp is a separate service. It searches and reads public pages; it does not run a mission or access your workspace.
Your first mission
- Choose a small task with a concrete artifact, such as “Create a README checklist for reviewing a small website's accessibility. Save it as Markdown.”
- Use
operator_start with your objective, provider (claude or codex), and a unique idempotency_key. Reuse that key for the same request after an uncertain response. - Keep the returned run ID. Inspect it with
operator_get_run. - List results with
operator_list_artifacts. Use operator_get_artifact to obtain metadata and the authorized download path. - Open and review the actual result before relying on it. A completed run is not a guarantee that the artifact meets your objective.
Tools and permissions
| Tools | Behavior | Permission |
|---|
| Status, read run, list artifacts, read artifact | Read your own account, mission, or artifact metadata. | operator:read |
| Connect Codex, check Codex | Begin or complete provider device authorization in your workspace. | operator:run |
| Start mission | Reserves trial/subscription usage and runs the selected provider. The mission can create or change files and access external services within its authorized environment. | operator:run |
| Billing | Reads plan information and available checkout or billing paths. Does not charge a payment. | operator:billing |
Hosted limits
Hosted missions currently run once through the selected provider. The installed local adaptive runtime is a separate capability. Hosted operator_adaptive_start, operator_adaptive_status, and operator_adaptive_cancel report that local boundary; they do not start, inspect, or cancel a local task.
The hosted input and approval boundary tools currently return run_not_waiting and approval_not_found. They do not deliver additional input or approve an action. Customer-supplied verification commands and a hosted adaptive loop are not offered by this connector.
Errors and recovery
- Unauthorized: reconnect through your client's normal Operator authorization flow.
- Insufficient scope: review the requested operation and authorize its required scope.
- Provider not authorized: complete provider setup in your Operator account. For Codex, finish the device authorization and check its status.
- Usage or entitlement unavailable: inspect status and billing before starting another mission.
- Unknown run or artifact: use an identifier belonging to the account currently connected.
- Uncertain start response: keep the same idempotency key; do not create duplicate missions.
Data and controls
Operator processes the account and workspace state, mission objective, run metadata, and artifacts needed for the requested work. Provider authorization is stored separately and encrypted at rest. Review the privacy policy for infrastructure providers, retention, and deletion requests. Remove provider access from your account and revoke the connector in your AI client when it is no longer needed.
For help, use Operator support or email info@blacklabelbots.com with your run ID and error code. Never include provider tokens or repository secrets.