Skip to content
GOCUX
Documentation
GOCUX / Documentationintegrations

Start with MCP in a local client

Connect only the tools a local task actually requires.

Connect only the tools a local task actually requires.

Practical procedure

  1. Use the MCP configuration mechanism of your installed compatible client. Inspect the server source, transport and requested permissions before enabling it.
  2. Begin with a read-only tool and a small task. Keep tool execution in the local client while GoCux Gateway handles the model turn.
  3. Review tool output as external data and verify any effect independently. Disable or revoke the connection when the task no longer needs it.

Separate the external system from GoCux authority

A named external tool in a workflow does not establish a native GoCux integration. Start with an authorized export, an already configured connector, or a separately implemented adapter. Keep external account credentials in the owning system. In GoCux, inspect the available connector and its grants; the fact that a connector is registered does not itself authorize a task to use it.

Contract example

Developer examples below describe routes on an authorized, configured GoCux control-plane base URL. They are request shapes or operation references, not claims that a particular public hostname exposes the API. Use the workspace for the corresponding human workflow; availability and permissions depend on the actual deployment.

GET /connectors — inspect connectors available to the authenticated company

GET /connectors/{connector_id}
GET /connector-defaults
GET /task-contexts/{context_id}/connectors

Inspect the result

The useful outcome is an explicit boundary: what information enters GoCux, which task can access it, and what result leaves. Start with a read-only sample and verify its source context. A local client or adapter owns the external invocation and its error handling unless an actual deployed connector provides that behavior.

What to keep explicit

This guide does not publish a GoCux-hosted MCP endpoint or installation command. A configured server is not automatically authorized for every task.

Handle incomplete and refused work

Authentication with the external system is separate from GoCux authentication. Missing grants, revoked permissions or unavailable connectors must remain visible; do not replace them with invented data. Publishing a marketplace listing, creating a paid external resource or sending messages is a separate action from preparing an integration guide.

Bring this workflow into your workspace.

Set the scope. Review the evidence. Approve the steps that need it.

Open the workspace

Keep exploring