Document how to publish MCP servers as Actors
メンテナーはふだん 1 日以内に返信
@TC-MO がすでに取り組んでいます。
2026年5月27日 から。
評価
この issue はまだ評価されていません。
説明
The "build and deploy MCP servers" content currently lives only on the blog (Build and deploy MCP servers in TypeScript). A Slack thread flagged that this should be promoted into docs, broadened in scope, and paired with a starter repo.
Current docs cover MCP almost entirely from the consumer side. Connecting clients to mcp.apify.com, configuring tool selection, OAuth (sources/platform/integrations/ai/mcp/). The publisher side, how to wrap an MCP server as an Actor, monetize it, register it with the Apify MCP server, is a one-liner in develop_ai_agents.md and conceptual prose in the Academy actorization playbook. No step-by-step guide exists.
Scope
A new how-to guide covering:
- Both transports as first-class paths: stdio (wrap existing stdio MCP server) and native remote streamable HTTP (not just proxy mode, which is all the current TS template covers)
- Step-by-step using existing templates: TypeScript MCP server, Python MCP server
- Configure standby mode, pay-per-event monetization, Actor metadata (webServerMcpPath, etc.)
- Explain the re-publishing model: when an MCP server Actor is in the store, its tools are exposed by mcp.apify.com - via explicit registration (?tools=user/actor-name) or dynamic discovery
- Explain the monetization narrative: any Apify user can call paid third-party MCP servers through a single Apify account; Apify handles billing and revenue share to creators
- Deploy via apify push and publish to Apify Store
Companion work
- Cross-links from:
- sources/platform/integrations/ai/mcp/index.md (consumer-side hub)
- sources/platform/actors/development/quick-start/develop_ai_agents.md (templates list)
- sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md (§ MCP servers and tools for AI)
- sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx (examples table)
Acceptance criteria
- Both TypeScript and Python templates referenced with deploy-ready configs
- Re-publishing via mcp.apify.com documented with a worked example (explicit and dynamic discovery)
- Monetization section explains PPE setup and revenue share for MCP-server Actors
- pnpm run build passes; pnpm run lint clean; all links resolve
- Cross-links added from the four touchpoints above
References
- Blog post: https://blog.apify.com/build-and-deploy-mcp-servers-typescript/
- Monorepo: https://github.com/apify/actor-mcp-servers
- Templates: TS, Py
- Existing consumer-side docs: sources/platform/integrations/ai/mcp/
- 主要言語
- JavaScript
- スター
- 82
- フォーク
- 240
- 平均マージ
- 4日 3時間
- マージ済み PR（30日）
- 40
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
apify/apify-docs のほかの issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
apify/apify-docs#3071 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
apify/apify-docs#3049 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
apify/apify-docs#2742 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1〜3時間 初心者へのやさしさ 82/100
apify/apify-docs#2741 ·
メンテナーはふだん 1 日以内に返信
-
low priority t-unblocking tech enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
apify/apify-docs#2451 ·
メンテナーはふだん 1 日以内に返信
apify/apify-docs の issue をすべて見る
似ている issue
-
good first issue
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
saayam-for-all/webapp#1919 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
Uuriko/project-room#3728 ·
メンテナーはふだん 1 日以内に返信
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
devops-thiago/ThrillhouseBot#1132 ·
メンテナーはふだん 1 日以内に返信
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
andromarces/agent-loops#886 ·
メンテナーはふだん 1 日以内に返信
-
bug effort:low model:light plan planner:gpt-6-1-sol tests
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信