Skip to content

README.md

Latest commit

 

History

History
178 lines (145 loc) · 5.67 KB

README.md

File metadata and controls

178 lines (145 loc) · 5.67 KB
Raw

Yandex Cloud Serverless Workflows MCP Server (Preview)

The server is running in preview mode, some features may be unstable

MCP server for managing Yandex Cloud Serverless Workflows - create, configure, and manage workflows with YAML specifications, executions, scheduling, and access control.

Table of Contents

Use Cases

Prompts examples:

  • List all workflows in my folder
  • Create a new workflow with YAML specification
  • Start workflow execution with input data
  • Get workflow execution status and history
  • Stop or terminate running execution
  • Update workflow specification
  • Configure workflow scheduling with cron expression
  • Manage access bindings for workflows

Installation and Usage

Configuration

To start working with Yandex Cloud Serverless Workflows MCP Server, you have to update your assistant's configuration (e.g. Cline, Roo Code or Claude Desktop) by adding yandex-cloud-workflows server.

There are two available ways:

1. NPM Client (recommended)

Provides authentication via OAuth (browser-based, default) or Yandex Cloud CLI (yc).

See the npm package documentation for more details.

Prerequisites:

  • Roles. Account to perform operations with this MCP Server must have the necessary roles (e.g., editor or serverless.workflows.admin).
  • Node.js 18.0.0 or higher
  • (Optional) Yandex Cloud CLI (yc) - required only when using CLI authentication

Authentication Options:

  • OAuth (default, recommended): Run the package without authentication flags. Browser-based authentication is used automatically.
  • OAuth with explicit account selection: Use -S <user or service account ID> or -u <email>
  • CLI: Use -p <profile> to authenticate via Yandex Cloud CLI (requires CLI installation)

Configuration:

{
  "mcpServers": {
    "yandex-cloud-workflows": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "@yandex-cloud/mcp",
        "-s", "workflows",
        "-H", "Folder-Id:<Folder ID (optional)>"
      ]
    }
  }
}

2. Streamable HTTP

Prerequisites:

  • Roles. Account to perform operations with this MCP Server must have the necessary roles (e.g., editor or serverless.workflows.admin).

  • IAM token. You can get it using Yandex Cloud CLI:

    • yc iam create-token for user account
    • yc iam create-token --impersonate-service-account-id <service-account-id> for service account

    The IAM token has a maximum lifespan of 12 hours. After expiration, it must be rotated.

Configuration:

{
  "mcpServers": {
    "yandex-cloud-workflows": {
      "type": "streamableHttp",
      "url": "https://workflows.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <YC IAM Token>",
        "Folder-Id": "<Folder ID (optional)>"
      }
    }
  }
}

Headers

Header Description Requireness
Folder-Id Yandex Cloud folder as default value for MCP tool's input field folder_id Optional
Authorization Yandex Cloud IAM Token for Streamable HTTP authorization Required for Streamable HTTP

Tools

Yandex Cloud Serverless Workflows MCP Server currently consists of 15 tools listed below:

Tool Description
workflow_get Get Yandex Cloud Serverless Workflow
workflows_list List Yandex Cloud Serverless Workflows in the folder
workflow_create Create Yandex Cloud Serverless Workflow
workflow_update Update Yandex Cloud Serverless Workflow
workflow_delete Delete Yandex Cloud Serverless Workflow
workflow_operations_list List Yandex Cloud Serverless Workflow operations
workflow_accesses_list List access bindings for Yandex Cloud Serverless Workflow
workflow_accesses_update Update access bindings for Yandex Cloud Serverless Workflow
workflow_execution_get Get Yandex Cloud Serverless Workflow execution
workflow_execution_list List Yandex Cloud Serverless Workflow execution
workflow_execution_start Start Yandex Cloud Serverless Workflow execution
workflow_execution_stop Stop Yandex Cloud Serverless Workflow execution
workflow_execution_terminate Terminate Yandex Cloud Serverless Workflow execution
workflow_execution_history_get Get Yandex Cloud Serverless Workflow execution history