Skip to content

Client integration

SharedData provides local data containers, an authenticated HTTP API, MCP access and worker execution. Choose the interface that fits your process boundary and grant only the permissions a client needs.

Data access through MCP

The SharedData package supplies the shareddata-mcp entry point. Configure it in a compatible agent client's MCP settings using the configuration and permissions of your own SharedData deployment. Review the supported tools and the deployment's authorization before granting access. Installing a client does not grant it access to your data.

Remote access and execution

Remote clients use the installation's endpoint and an appropriately scoped token:

Variable Meaning
SHAREDDATA_ENDPOINT Your SharedData server's HTTPS origin
SHAREDDATA_TOKEN A token permitted to perform the requested operation

Keep values in your environment or secret store. See the HTTP API guide for remote container access and batch jobs for tracked execution.

A dispatch identifies a worker, repository, routine and arguments. Generic identifiers such as operator@WORKER, ExampleProject and jobs/example are illustrative, not a preconfigured worker fleet. Consult the client interface's documentation for accepted routine formats and arguments; different entry points can use different conventions.

Confirm the result

HTTP 201 means the command was queued. It does not mean the routine completed. Check the worker, schedule state, job result and logs before resubmitting a command. Permissions, credentials, lifecycle management and data ownership remain with the SharedData deployment operator.