MCP Server

Overview

co includes a built-in Model Context Protocol (MCP) server. This allows AI assistants like Claude Desktop, Claude Code, or any MCP-compatible client to manage configs, namespaces, groups, and S3 files through natural conversation.

The MCP server is stateless — each request is independently authenticated and processed. It uses Streamable HTTP transport at the /mcp endpoint.

Authentication

The MCP server uses the same API keys as the REST API. You can authenticate in two ways:

Authorization header: Authorization: Bearer sk-xxx
URL token parameter: /mcp?token=sk-xxx

Create API keys in Workspace Settings > API Keys.

Setup

Claude Desktop

Add the following to your Claude Desktop MCP configuration:

json

{  "mcpServers": {    "co": {      "type": "http",      "url": "https://co.tlyboy.com/mcp?token=sk-xxx"    }  }}

{  "mcpServers": {    "co": {      "type": "http",      "url": "https://co.tlyboy.com/mcp?token=sk-xxx"    }  }}

Claude Code

Add to your project's .mcp.json:

json

{  "mcpServers": {    "co": {      "type": "http",      "url": "https://co.tlyboy.com/mcp?token=sk-xxx"    }  }}

{  "mcpServers": {    "co": {      "type": "http",      "url": "https://co.tlyboy.com/mcp?token=sk-xxx"    }  }}

Or use the CLI:

Other MCP Clients

Any MCP client that supports Streamable HTTP transport can connect to:

Pass authentication via the Authorization: Bearer sk-xxx header or the ?token=sk-xxx query parameter.

Available Tools

list_namespaces

List all namespaces in the workspace.

No parameters required.

Example prompt: "Show me all namespaces"

list_groups

List config groups within a namespace.

Parameter	Type	Required	Description
`namespaceId`	string	Yes	Namespace ID

Example prompt: "List groups in the production namespace"

list_configs

List configs with optional filters.

Parameter	Type	Required	Description
`namespaceId`	string	No	Filter by namespace
`groupId`	string	No	Filter by group
`search`	string	No	Search config names

Example prompt: "Show me all configs in the production namespace"

get_config

Get a specific config by ID or by namespace/group/name path.

Parameter	Type	Required	Description
`id`	string	No	Config ID
`namespace`	string	No	Namespace name (for path lookup)
`group`	string	No	Group name (for path lookup)
`name`	string	No	Config name (for path lookup)

Provide either id or all three of namespace, group, and name.

Example prompt: "Get the database connection string from production/database"

create_config

Create a new config in a group.

Parameter	Type	Required	Description
`groupId`	string	Yes	Target group ID
`name`	string	Yes	Config name
`format`	string	No	Format (string, json, yaml, toml, env)
`content`	string	No	Config content
`description`	string	No	Description

Example prompt: "Create a new JSON config called 'settings' in group abc-123"

update_config

Update an existing config.

Parameter	Type	Required	Description
`id`	string	Yes	Config ID
`content`	string	No	New content
`format`	string	No	New format
`name`	string	No	New name
`description`	string	No	New description

Example prompt: "Update the database URL config to use the new host"

delete_config

Delete a config.

Parameter	Type	Required	Description
`id`	string	Yes	Config ID

Example prompt: "Delete the deprecated config abc-123"

list_connections

List all S3 connections in the workspace.

No parameters required.

Example prompt: "Show me all S3 connections"

browse_files

Browse files in an S3 connection.

Parameter	Type	Required	Description
`connectionId`	string	Yes	S3 connection ID
`prefix`	string	No	Path prefix to browse

Example prompt: "Browse files in the images folder"

get_file_url

Get a URL to access a file.

Parameter	Type	Required	Description
`connectionId`	string	Yes	S3 connection ID
`key`	string	Yes	File key/path

Example prompt: "Get the URL for images/hero.jpg"

get_upload_url

Get a presigned URL for uploading a file.

Parameter	Type	Required	Description
`connectionId`	string	Yes	S3 connection ID
`key`	string	Yes	Target file key/path
`contentType`	string	No	MIME type

Example prompt: "Give me an upload URL for documents/report.pdf"