Yandex 360 (ycli)

• スクリプトに適したコマンドライン。 パイプで渡すと JSON を出力し、jq ですぐに処理できます。すべての書き込み操作で --dry-run を使え、失敗の種類ごとに終了コードが返ります。
• 信頼できるエージェント向け MCP サーバー。 各ツールは、読み取り、書き込み、破棄のどれを行うかを明示します。読み取り専用、または日常的に使うツールだけを提供できます。
• 型付きの Python SDK。 すべての応答に Pydantic モデルを用意し、テストスイートで実行されるサンプルも含まれています。
• データを慎重に扱います。 削除前には確認を求め、トークンは Yandex 独自のホストにのみ送信します。

ドキュメント：ycli.savaznatnov.dev。

インストール

uv tool install 'yandex-cli[mcp]'   # the ycli command, with the MCP server
uvx yandex-cli --help               # or run it once, without installing
pipx install 'yandex-cli[mcp]'      # or with pipx

コマンドは ycli（別名 yandex-cli）です。次に、サインインします：ycli auth login（方法）。

Python で開発しますか？SDK をプロジェクトに追加してください：uv add yandex-cli。

追加機能	追加されるもの	インストール
mcp	MCP サーバー、ycli mcp start	uv tool install 'yandex-cli[mcp]'
service-account	Yandex Cloud のサービスアカウントキーを使う SDK の ServiceAccountAuth	uv add 'yandex-cli[service-account]'

AI クライアントを接続する

どのクライアントでも、使用する MCP サーバーは uvx --from 'yandex-cli[mcp]' ycli mcp start で、必要な変数も同じ 2 つです。

クライアント	最も手早い方法
Claude Code	/plugin marketplace add bim-ba/ycli を実行し、続けて /plugin install yandex-360@ycli を実行します
Claude Desktop	最新リリースの .mcpb バンドルを開きます
Cursor	ワンクリックでインストール
VS Code	ワンクリックでインストール
Windsurf (Devin Desktop)	設定ファイル
Zed	設定ファイル
Codex	設定ファイル
Gemini CLI	設定ファイル
opencode	設定ファイル
その他の MCP クライアント	コピーする 3 つの値

また、Docker イメージ ghcr.io/bim-ba/ycli（サーバーとして、または通常の CLI として）、パイプライン、および公式 MCP Registry のエントリー io.github.bim-ba/ycli も利用できます。

うまく動作しませんか？動作しない場合。

使い方

コマンドライン

ycli tracker issues get TRACKER-1                  # a table at a terminal
ycli tracker issues get TRACKER-1 | jq .summary    # JSON when piped
ycli -o yaml wiki pages get onboarding             # or pick: -o json | yaml | pretty | csv | markdown | ndjson | name
ycli tracker boards delete 7 --dry-run             # print the request a write would send
ycli tracker boards delete 7 --yes                 # a delete asks first; --yes answers
ycli api issues/TRACKER-1 --service tracker        # an endpoint ycli does not wrap

詳細：CLI のスクリプト化、ラップされていないエンドポイントの呼び出し、CLI リファレンス。

MCP サーバー

ycli mcp start                     # every tool, reads and writes
ycli mcp start --read-only         # reads only
ycli mcp start --toolsets core     # about 40 everyday tools, for a client that caps the count
ycli mcp methods --toolsets core   # list the tool names without starting the server

詳細：MCP サーバーの提供、チーム向けのHTTP 経由でのセルフホスト、ツールリファレンス。

Python

from ycli.yandex.tracker.client import TrackerClient

tracker = TrackerClient(oauth_token="…", organization_id="…")
print(tracker.issues.get("TRACKER-1").summary)

詳細：SDK リファレンス。

Claude Code プラグイン

/plugin marketplace add bim-ba/ycli
/plugin install yandex-360@ycli

MCP サーバーに加えて、エージェントにコマンドと API の仕様上の注意点を教える 5 つのスキル（yandex-360、yandex-360-tracker、yandex-360-wiki、yandex-360-forms、yandex-360-datalens）を追加します。ソース：plugins/yandex-360/。

設定

ycli auth login     # gets a token through Yandex ID, finds your organization, saves both to .env
ycli auth status    # whose token it is, and whether each service accepts it
ycli doctor         # something not working? every check in order, with the fix

初回の ycli auth login には、ご自身の Yandex OAuth アプリが必要です。認証で設定方法を説明しています。ycli は環境変数または .env ファイルから 2 つの変数を読み込みます。

YANDEX_ID_OAUTH_TOKEN=...        # a Yandex OAuth token with Tracker, Wiki and Forms access
YANDEX_ID_ORGANIZATION_ID=...    # your Yandex 360 organization id

タイムアウト、再試行、制限、ログ、終了コードについては、設定リファレンスをご覧ください。

対応範囲

ycli は、Tracker、Wiki、Forms、DataLens API の 88 リソースにまたがる 468 件の操作をラップします。すべての操作を Python SDK と CLI から利用でき、458 個の MCP ツールがエージェントに提供します（各サービス 456 個に加え、schema_get、status_get）。

凡例。 CLI または MCP の ✅ は、そのインターフェースでリソースを利用できることを示します。MCP ツールには正確なヒントが付いており（読み取りには readOnlyHint、書き込みには破壊的かべき等かを明記）、ycli mcp start --read-only は読み取り操作のみを提供します。リソース名と操作名は、公式の Yandex API リファレンスへのリンクです。Yandex が公開している内容に対する操作の状態は、次の 3 種類です。対応済み（マークなし）：ycli は公開されているすべてのパラメーターを送信し、公開されているすべてのフィールドを読み取ります。一部対応（◐）：ycli は操作をラップしていますが、どこかに差異があります。このマークは、差異の内容と理由を記載した行へのリンクです。未対応（○）：Yandex は公開していますが、ycli はラップしていません。これらは各サービスの下に一覧表示されています。Wiki、Forms、DataLens は OpenAPI ドキュメントを基準に測定しています。Tracker は OpenAPI ドキュメントを公開していないため、リファレンスページ（操作、およびページに記載されている場合はクエリパラメーター）を基準に測定しています。DataLens はセクションごとに順次対応中です。ycli が着手していないセクションの操作は未対応ではなく、保留中です。コードから scripts/gen_coverage.py で生成されています。手作業で編集しないでください。

Tracker

34 リソース · 190 件の操作 · 187 個の MCP ツール

課題と作業項目

Resource	Operations	CLI	MCP
issues	get · search · count · create · update · move · suggest · scroll_clear · update_bulk · move_bulk · transition_bulk · import_	✅	✅
comments	list · get · create · update · delete · reactions_create · import_	✅	✅
links	list · list_filtered · create · delete · import_	✅	✅
transitions	list · execute	✅	✅
worklog	list · search · list_global · create · update · delete · import_	✅	✅
changelog	list	✅	✅
checklists	list · create · update · delete · clear	✅	✅
attachments	list · download · thumbnails_download · get · delete · upload · upload_temp · import_ · import_for_comment	✅	✅
remotelinks	list · create · delete	✅	✅

Agile boards

Resource	Operations	CLI	MCP
boards	list · get · create · update · delete	✅	✅
sprints	list · get · create · update · delete · start · archive	✅	✅
columns	list · get · create · update · delete	✅	✅

Dictionaries

Resource	Operations	CLI	MCP
priorities	list · create · update	✅	✅
statuses	list · create · update	✅	✅
resolutions	list · create · update	✅	✅
issuetypes	list · create · update	✅	✅
linktypes	list	✅	✅

Fields, queues & structure

Resource	Operations	CLI	MCP
fields	list · get · create · update · categories_create · categories_update	✅	✅
localfields	list · get · create · update	✅	✅
components	list · create · update · list_for_queue · get · delete · user_permissions_get · group_permissions_get	✅	✅
queues	list · get · tags_list · versions_list · fields_list · create · delete · restore · permissions_update · tags_delete · versions_create · versions_get · versions_update · versions_delete · user_permissions_get · group_permissions_get	✅	✅
workflows	list · get · list_for_queue · create · update · actions_update · delete	✅	✅
projects	list · get · queues_list · create · update · delete	✅	✅

Automation & bulk

Resource	Operations	CLI	MCP
macros	list · get · create · update · delete	✅	✅
triggers	list · get · create · update · webhook_log_list	✅	✅
autoactions	get · create · logs_list · logs_get	✅	✅
dashboards	create · widgets_create_cycle_time	✅	✅
bulk	get · issues_list	✅	✅

Entities, users & search

Resource	Operations	CLI	MCP
entities	create · get · update · delete · search · events_list · permissions_get · permissions_update · permissions_get_direct · permissions_update_direct · update_bulk · bulk_get · reports_create · comments_list · comments_list_relative · comments_get · comments_create · comments_update · comments_delete · checklists_create · checklists_update · checklists_items_update · checklists_delete · checklists_items_delete · checklists_move · links_list · links_create · links_delete · attachments_list · attachments_get · attachments_download · attachments_attach · attachments_delete	✅	✅
users	get · list	✅	✅
applications	list	✅	✅
filters	get · create · update · delete	✅	✅
gaps	create · search · delete	✅	✅
me	get	✅	✅

対象外（2）

• ○ GET /boards：boards list は、ページ分割された GET /boards/_paginate を読み取ります
• ○ GET /users：users list は、ページ分割された GET /users/_relative を読み取ります

Wiki

10 個のリソース · 58 個の操作 · 56 個の MCP ツール

ページ

リソース	操作	CLI	MCP
ページ	ID で取得 · 取得 · 子孫の一覧 · ID による子孫の一覧 · グリッドの一覧 · 作成 · 更新 · 削除 · 追記 · 複製 · 移動 · リビジョンの一覧 · バックリンクの一覧 · 検索	✅	✅
リソース	一覧	✅	✅
復元	復元	✅	✅

コラボレーション

Resource	Operations	CLI	MCP
comments	list · thread_list · thread_get · create · delete	✅	✅
attachments	list · get · previews_download · download · download_by_url · delete · attach · upload	✅	✅
access	create · update · delete · clear	✅	✅

Grids (dynamic tables)

Resource	Operations	CLI	MCP
grids	get · create · update · delete · rows_create · rows_delete · rows_move · columns_create · columns_delete · columns_move · cells_update · clone · columns_suggest · columns_update · rows_update	✅	✅

Async & uploads

Resource	Operations	CLI	MCP
operations	clone_get · clone_inline_grid_get · move_get	✅	✅
uploadsessions	create · get · parts_upload · finish · abort · abort_all	✅	✅

Identity

Resource	Operations	CLI	MCP
me	get	✅	✅

Forms

16 resources · 86 operations · 79 MCP tools

Surveys & questions

Resource	Operations	CLI	MCP
surveys	list · get ◐ · create ◐ · update ◐ · delete · publish · unpublish	✅	✅
questions	get · list · create ◐ · update ◐ · delete ◐ · move	✅	✅
conditions	question_list · question_get · question_create · question_update · question_delete · question_update_operator · page_list · page_get · page_create · page_update · page_delete · page_update_operator · submit_list · submit_get · submit_create · submit_update · submit_delete · submit_update_operator · hook_list · hook_get · hook_create · hook_update · hook_delete · hook_update_operator	✅	✅
access	list · update · grant · revoke	✅	✅
history	list	✅	✅

Responses & export

Resource	Operations	CLI	MCP
answers	get · list · columns_list · export · export_results_get · export_download · integrations_list · delete · restore	✅	✅
operations	get	✅	✅

Integrations

Resource	Operations	CLI	MCP
hooks	list · get · create · update · delete	✅	✅
subscriptions	list · get · create ◐ · update ◐ · delete · attach	✅	✅
variables	list	✅	✅
notifications	list · get · status_get · restart · cancel · errors_list	✅	✅

Distribution

Resource	Operations	CLI	MCP
keysets	list · get · create · update · delete · download	✅	✅
filling	get · submit · suggest	✅	✅

Media

Resource	Operations	CLI	MCP
files	upload · verify · download · delete	✅	✅
images	upload · clone	✅	✅

Identity

Resource	Operations	CLI	MCP
me	get	✅	✅

DataLens

28 resources · 134 operations · 134 MCP tools

Organization

Resource	Operations	CLI	MCP
tenant	details_get	✅	✅
members	list	✅	✅
licensing	licenses_list · licenses_assign · limit_get · limit_set	✅	✅

Collections & workbooks

Resource	Operations	CLI	MCP
collections	get · list_by_ids · content_list · breadcrumbs_list · permissions_get_root · access_bindings_list · create · update · move · move_bulk · delete · delete_bulk · access_bindings_update	✅	✅
workbooks	get · list · list_by_ids · access_bindings_list · entries_list · create · update · move · move_bulk · delete · delete_bulk · access_bindings_update	✅	✅
workbookexports	start · status_get · result_get · cancel	✅	✅
workbookimports	start · status_get	✅	✅

Entries

Resource	Operations	CLI	MCP
entries	list · relations_list · permissions_get · revisions_list · rename	✅	✅
entrylocks	create · extend · delete	✅	✅
permissions	get_bulk	✅	✅
sharedentries	access_bindings_list · access_bindings_update	✅	✅
audit	entries_updates_list · entry_permissions_get	✅	✅

Data

Resource	Operations	CLI	MCP
connections	get · create · update · delete	✅	✅
datasets	get · create · update · delete · validate · data_get	✅	✅

Charts, dashboards, reports & pages

Resource	Operations	CLI	MCP
charts	data_get · wizard_get · wizard_create · wizard_update · wizard_delete · ql_get · ql_create · ql_update · ql_delete · editor_get · editor_create · editor_update · editor_delete	✅	✅
dashboards	get · create · update · delete	✅	✅
reports	get · create · update · delete	✅	✅
htmlpages	get · create · update · delete · preview_url_get	✅	✅

SQL

Resource	Operations	CLI	MCP
sqlqueries	get · create · update · delete · run	✅	✅

Cloud environments

Resource	Operations	CLI	MCP
cloudenvironments	list · get · create · update · delete	✅	✅
cloudenvironmentstorage	bucket_objects_list · bucket_object_metadata_get · bucket_download_url_create · bucket_upload_url_create	✅	✅
restcatalogs	list · create	✅	✅
lakehouseoperations	get	✅	✅
trinoclusters	list · get · create · delete · start · stop · catalog_create · catalog_delete · resource_presets_list · resource_preset_get	✅	✅
sparkclusters	list · get · create · delete · start · stop · resource_presets_list · resource_presets_get	✅	✅
sparkapplications	list · get · create · cancel · log_list	✅	✅

Embedding

リソース	操作	CLI	MCP
埋め込み	一覧表示 · 作成 · 更新 · 削除	✅	✅
埋め込みシークレット	取得 · 一覧表示 · 作成 · 削除	✅	✅

未対応（9）

• ○ POST /rpc/checkFavorites：新しいセクションが2026-10に公開されました。ラップ方法は未定です
• ○ POST /rpc/createFolder：古い配置モデル（フォルダー）です。組織内に確認できる対象がありません（#394）
• ○ POST /rpc/deleteFolder：古い配置モデル（フォルダー）です。組織内に確認できる対象がありません（#394）
• ○ POST /rpc/dlsSuggest：古い配置モデル（フォルダー）です。組織内に確認できる対象がありません（#394）
• ○ POST /rpc/getPermissions：古い配置モデル（フォルダー）です。組織内に確認できる対象がありません（#394）
• ○ POST /rpc/listDirectory：古い配置モデル（フォルダー）です。組織内に確認できる対象がありません（#394）
• ○ POST /rpc/listFavorites：新しいセクションが2026-10に公開されました。ラップ方法は未定です
• ○ POST /rpc/modifyPermissions：古い配置モデル（フォルダー）です。組織内に確認できる対象がありません（#394）
• ○ POST /rpc/moveFolderEntry：古い配置モデル（フォルダー）です。組織内に確認できる対象がありません（#394）

上記の各リソースと操作は、Yandex API リファレンスへのディープリンクになっています。468 件の操作のうち、406 件はそれぞれのエンドポイントページに、20 件はリソースのページにリンクしています。`datalens.cloudenvironments`、`datalens.cloudenvironments.create`、`datalens.cloudenvironments.delete`、`datalens.cloudenvironments.get`、`datalens.cloudenvironments.list`、`datalens.cloudenvironments.update`、`datalens.cloudenvironmentstorage`、`datalens.cloudenvironmentstorage.bucket_download_url_create`、`datalens.cloudenvironmentstorage.bucket_object_metadata_get`、`datalens.cloudenvironmentstorage.bucket_objects_list`、`datalens.cloudenvironmentstorage.bucket_upload_url_create`、`datalens.lakehouseoperations`、`datalens.lakehouseoperations.get`、`datalens.restcatalogs`、`datalens.restcatalogs.create`、`datalens.restcatalogs.list`、`datalens.sparkapplications`、`datalens.sparkapplications.cancel`、`datalens.sparkapplications.create`、`datalens.sparkapplications.get`、`datalens.sparkapplications.list`、`datalens.sparkapplications.log_list`、`datalens.sparkclusters`、`datalens.sparkclusters.create`、`datalens.sparkclusters.delete`、`datalens.sparkclusters.get`、`datalens.sparkclusters.list`、`datalens.sparkclusters.resource_presets_get`、`datalens.sparkclusters.resource_presets_list`、`datalens.sparkclusters.start`、`datalens.sparkclusters.stop`、`datalens.sqlqueries`、`datalens.sqlqueries.create`、`datalens.sqlqueries.delete`、`datalens.sqlqueries.get`、`datalens.sqlqueries.run`、`datalens.sqlqueries.update`、`datalens.tenant`、`datalens.tenant.details_get`、`datalens.trinoclusters`、`datalens.trinoclusters.catalog_create`、`datalens.trinoclusters.catalog_delete`、`datalens.trinoclusters.create`、`datalens.trinoclusters.delete`、`datalens.trinoclusters.get`、`datalens.trinoclusters.list`、`datalens.trinoclusters.resource_preset_get`、`datalens.trinoclusters.resource_presets_list`、`datalens.trinoclusters.start`、`datalens.trinoclusters.stop`、`tracker.linktypes`、`tracker.linktypes.list`については、公開 API リファレンスがまだ存在せず、プレーンテキストで表示されます。意図的な除外（公開 REST API のない UI 専用エンドポイント）とメソッドごとの注記については、`CONTRIBUTING.md`を参照してください。

公開 API との比較

ycli が送信する内容を、契約テストから再現し、Yandex が公開している内容と比較します。対象は Wiki、Forms、DataLens の OpenAPI ドキュメントと Tracker の API リファレンスです（文章形式のため、各ページに記載された操作とクエリパラメーターのみ比較します）。リクエストボディは、ycli にその型付きモデルがあり、かつモデルが閉じている場合にのみ比較します。その件数は比較したボディ列に示されているため、リストが空でも一致を意味するわけではありません。公開側のスナップショットはscripts/api_snapshot/にあります。週次ジョブがスナップショットを再取得し、Yandex に変更があった場合は issue を作成します。

サービス	公開済み	ラップ済み	未ラップ	異なる操作	比較したボディ	ソース
Tracker	190	188	0（意図的に2件）	0	—	API リファレンス
Wiki	56	56	0	0	24件中24件	OpenAPI
Forms	84	84	0	8	30件中26件	OpenAPI
DataLens	143	134	0（意図的に9件）	0	131件中131件	OpenAPI

Tracker：異なる点

意図的にラップしていないもの

操作	理由
GET /boards	boards listはページ分割されたGET /boards/_paginateを読み込みます
GET /users	users listはページ分割されたGET /users/_relativeを読み込みます

ycli が送信するが、公開されていないもの

ycli	リクエスト
entities.attachments_download	GET /attachments/{file_id}/{filename}
linktypes.list	GET /linktypes

Wiki：異なる点

フォーム：異なる点

パラメーターとフィールド

操作	ycli	相違点	そのままにする理由
POST /surveys	surveys.create	ycli が送信する、公開されていない本文フィールド：is_public、is_published、language 公開されていないモデルフィールド：modified	API はこれを受け付け、無視します（2026-10-04 にライブ環境で確認済み） API はこれを返します（2026-10-04 にライブ環境で確認済み）が、公開スキーマには含まれていません
GET /surveys/{survey_id}	surveys.get	公開されていないモデルフィールド：modified	API はこれを返します（2026-10-04 にライブ環境で確認済み）が、公開スキーマには含まれていません
PATCH /surveys/{survey_id}	surveys.update	ycli が送信する、公開されていない本文フィールド：is_public、is_published、language 公開されていないモデルフィールド：modified	API はこれを受け付け、無視します（2026-10-04 にライブ環境で確認済み） API はこれを返します（2026-10-04 にライブ環境で確認済み）が、公開スキーマには含まれていません
POST /surveys/{survey_id}/hooks/{hook_id}/subscriptions	subscriptions.create	ycli が送信する、公開されていない本文フィールド：id	1 つのモデルが本文を構築して応答を読み取ります。応答には id が含まれます
PATCH /surveys/{survey_id}/hooks/{hook_id}/subscriptions/{subscription_id}	subscriptions.update	ycli が送信する、公開されていない本文フィールド：id	1 つのモデルが本文を構築して応答を読み取ります。応答には id が含まれます
POST /surveys/{survey_id}/questions	questions.create	ycli が送信する、公開されていない本文フィールド：id	API はこれを受け付け、無視します（2026-10-04 にライブ環境で確認済み）
DELETE /surveys/{survey_id}/questions/{question_id}	questions.delete	ycli が送信する、公開されていないクエリパラメーター：force	API はこれを受け付け、無視します（2026-10-04 にライブ環境で確認済み）
PATCH /surveys/{survey_id}/questions/{question_id}	questions.update	ycli が送信する、公開されていない本文フィールド：id	API はこれを受け付け、無視します（2026-10-04 にライブ環境で確認済み）

DataLens：異なる点

意図的にラップしていないもの

操作	理由
POST /rpc/checkFavorites	新しいセクションが2026-10に公開されました。ラッパーは未決定です
POST /rpc/createFolder	古い配置モデル（フォルダー）です。これを検証できる組織がありません（#394）
POST /rpc/deleteFolder	古い配置モデル（フォルダー）です。これを検証できる組織がありません（#394）
POST /rpc/dlsSuggest	古い配置モデル（フォルダー）です。これを検証できる組織がありません（#394）
POST /rpc/getPermissions	古い配置モデル（フォルダー）です。これを検証できる組織がありません（#394）
POST /rpc/listDirectory	古い配置モデル（フォルダー）です。これを検証できる組織がありません（#394）
POST /rpc/listFavorites	新しいセクションが2026-10に公開されました。ラッパーは未決定です
POST /rpc/modifyPermissions	古い配置モデル（フォルダー）です。これを検証できる組織がありません（#394）
POST /rpc/moveFolderEntry	古い配置モデル（フォルダー）です。これを検証できる組織がありません（#394）

開発

uv sync --all-extras   # the tests use every extra
uv run pytest          # 100% coverage gate; HTTP is stubbed, no live network

レイアウトと、それを規則的に保つ不変条件についてはARCHITECTURE.mdをご覧ください。CONTRIBUTING.mdには規約とエンドポイントの追加方法が記載されています。コントリビューションを歓迎します。

ライセンス

MIT © 2026 Sava Znatnov