MCP server

The MCP server is a Deckhouse Development Platform (DDP) component that implements the Model Context Protocol (MCP). It enables external AI clients, such as LM Studio and Claude Desktop, to interact with the platform. The server uses JSON-RPC 2.0 and provides tools for working with platform resources and proxying requests to external infrastructure services.

MCP is an open protocol for connecting AI models to external systems. For details, refer to the official MCP website.

Available tools

The following built-in platform tools are available. Tools of the external and custom types become available after you synchronize the catalog and add them to an MCP collection.

get_resources

Gets a list of resources.

Parameters: None.

Returns: A list of resources.

Example:

Get a list of resources

get_external_services

Gets a list of external services, such as GitLab and SonarQube.

Parameters: None.

Returns: A list of external services.

Example:

Get a list of external services

get_resource_entities

Gets all entities of the selected resource.

Parameters:

Returns: A list of resource entities.

Example:

Get all services and show their names and creation dates

get_entity

Gets one entity by UUID.

Parameters:

Returns: Data for one entity.

Example:

Get the entity with UUID 3fa85f64-5717-4562-b3fc-2c963f66afa6

get_entity_relations

Gets entity relations.

Parameters:

Returns: A list of entity relations.

Example:

Get the relations of the "api-gateway" entity in the "Services" resource

get_external_data

Sends an HTTP request to an external service using the user’s credentials.

Parameters:

Credentials and headers are taken from the external service settings in the platform.

Returns: The result of the HTTP request to the external service.

Example:

Get a list of projects from the external GitLab service

get_actions

Gets a list of actions.

Parameters: None.

Returns: A list of actions.

Example:

Get a list of actions

get_datasources

Gets a list of data sources.

Parameters: None.

Returns: A list of data sources.

Example:

Get a list of data sources

get_processes

Gets a list of processes.

Parameters: None.

Returns: A list of processes.

Example:

Get a list of processes

Connecting to the MCP server

LM Studio

1. Get the connection parameters:

   • Sign in to Deckhouse Development Platform.
   • Get an API token under Profile.
   • Note the platform URL, for example, https://ddp.example.com.

2. Configure LM Studio:

   • Open LM Studio.
   • Open Settings.
   • Find MCP Servers or Model Context Protocol.
   • Select Add Server.

3. Configure the server:

   • Server Name: DDP MCP Server, or another name.
   • Server URL: https://<DOMAIN>/api/v2/mcp.
   • Transport: HTTP or JSON-RPC.
   • Authentication:
     • Type: Bearer Token or an equivalent that uses the Authorization header.
     • Header: Authorization: Bearer <your_api_token>.
     • Token: Enter the platform API token from Profile.

4. Verify the connection:

   • Save the configuration.
   • LM Studio connects to the server after saving.
   • After a successful connection, the following tools are available:
     • get_resources — Gets a list of resources.
     • get_external_services — Gets a list of external services, such as GitLab and SonarQube.
     • get_resource_entities — Gets all entities of the selected resource.
     • get_entity — Gets one entity by UUID.
     • get_entity_relations — Gets entity relations by resource and identifier.
     • get_external_data — Sends an HTTP request to an external service using the user’s credentials.
     • get_actions — Gets a list of actions.
     • get_datasources — Gets a list of data sources.
     • get_processes — Gets a list of processes.

After connecting, you can use these tools in conversations with models.

All calls use your access permissions.

Connecting other MCP clients

The Deckhouse Development Platform MCP server is compatible with any client that supports MCP over JSON-RPC 2.0.

To connect a client:

1. Endpoint URL: https://your-platform.com/api/v2/mcp.
2. Protocol: JSON-RPC 2.0.
3. Authentication:
   • Header: Authorization: Bearer YOUR_API_TOKEN.
   • YOUR_API_TOKEN is your platform API token from Profile.
4. Method: POST.

MCP server request example

HTTP headers:

Authorization: Bearer your-api-token-here
Content-Type: application/json

Request body:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_resource_entities",
    "arguments": {
      "resource_uuid": "target-resource-uuid"
    }
  }
}

MCP server response example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[{\"uuid\":\"...\",\"name\":\"Service 1\",\"properties\":{...}},...]"
      }
    ]
  }
}

Security

Authentication:

• Every MCP server request must be authenticated with an API token from Profile. Pass the token in the Authorization: Bearer <api_token> header.
• Access permissions match your platform user permissions.

Access permissions:

• Tools use the same permissions as the user.
• If you cannot access a resource, the tool returns an access error.
• Data is filtered according to your RBAC permissions.

Troubleshooting

Cannot connect to the server

If you cannot connect to the server:

• Verify that the URL is correct and ends with /api/v2/mcp.
• Verify that the API token is valid.
• Verify that the platform is accessible from your computer.
• Check the firewall and proxy settings.

Authentication error

If authentication fails:

• Verify the token format.
• Verify that the token has not expired.
• Verify that you use the Authorization: Bearer <api_token> header.

Tool returns an access error

If a tool returns an access error:

• Verify that your user has permission to access the requested resource.
• Verify the resource name or identifier.
• Ask the platform administrator to verify your access permissions.

No data returned

If no data is returned:

• Verify the request parameters.
• Verify that the resource exists and contains entities.
• Check the platform logs for detailed error information.