MCP Server Not Showing in Integrations on AFFiNE Cloud Free Workspace

[rudolf1118]

Hi, I created a new AFFiNE Cloud Free workspace specifically to use the official AFFiNE MCP Server with Claude Code.

According to the current AFFiNE documentation, I should see Settings → Integrations → MCP Server, but my Integrations page only shows Readwise and Web Clipper.

Is MCP currently being rolled out gradually to AFFiNE Cloud workspaces? Is there a way to enable it for my workspace?

I also need read/write MCP access (create_document and update_document), not only read-only access. Is write access currently available for new Free Cloud workspaces?

[hippi345]

Two separate things going on, from what I can tell in the source.

The MCP card only shows for cloud workspaces on a server with AI enabled. Calendar has the same cloud-only flag, so if you don't see Calendar either, the app thinks your workspace is local (happens if it was created while signed out). Enable AFFiNE Sync in workspace settings, or create one while signed in on app.affine.pro, and it should appear. Also make sure the client is recent.

Second, write tools aren't on production cloud yet. The default toolset is read_document and doc_search; create/update are only registered on dev/canary servers. So on app.affine.pro expect read-only MCP for now, and upgrading from Free won't change that since it's tied to the server environment, not the plan.

[Magken91]

Not sure .how do I fix this On Oct 17, 2026 7:14 PM, Joel Town Road ***@***.***> wrote: Two separate things going on, from what I can tell in the source. The MCP card only shows for cloud workspaces on a server with AI enabled. Calendar has the same cloud-only flag, so if you don't see Calendar either, the app thinks your workspace is local (happens if it was created while signed out). Enable AFFiNE Sync in workspace settings, or create one while signed in on app.affine.pro, and it should appear. Also make sure the client is recent. Second, write tools aren't on production cloud yet. The default toolset is read_document and doc_search; create/update are only registered on dev/canary servers. So on app.affine.pro expect read-only MCP for now, and upgrading from Free won't change that since it's tied to the server environment, not the plan. —Reply to this email directly, view it on GitHub, or unsubscribe.Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today! You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[hippi345]

sure, steps:

1. update the app, or just use app.affine.pro in the browser
2. sign in
3. open the workspace settings. if it offers to enable AFFiNE Cloud / Sync, the workspace is still local, so turn that on (or make a new workspace while signed in and pick Cloud)
4. go to Settings > Integrations, the MCP Server card should be there

heads up it's read-only on app.affine.pro for now, so create/update won't work yet on any plan.