Skip to content

docs: add Meko Remote MCP Server connection guide - #1171

Draft
thierrypdamiba wants to merge 3 commits into
mainfrom
docs/meko-remote-mcp-server
Draft

docs: add Meko Remote MCP Server connection guide#1171
thierrypdamiba wants to merge 3 commits into
mainfrom
docs/meko-remote-mcp-server

Conversation

@thierrypdamiba

Copy link
Copy Markdown
Contributor

Adds a connection guide for Meko, which hosts a remote MCP server for agent memory at mcp.mekodata.ai, built on YugabyteDB. Placed alongside the other remote MCP server vendors and following the same structure as the recent Salesforce, HubSpot, Snowflake, and GitHub guides.

Requested by Yugabyte in #ext-arcade-x-yugabyte. They will publish a mirror on their docs site linking back.

What it covers

  • The datapack model, and the grant levels (owner, maintainer, contributor, viewer) that decide what a gateway can reach
  • OAuth 2.0 setup using Meko's dynamic client registration, including the redirect URI Arcade allocates
  • The static API key alternative, with an explicit warning that it collapses every gateway user into one Meko identity
  • Troubleshooting for the behaviors that surprise people once a second person joins a workspace

Verification

Tested against a live gateway with two real Meko accounts, an owner and a contributor:

  • Registered the server, all 23 tools discovered, 8 exposed through a gateway and called from Claude Code
  • Confirmed members cannot read each other's private memories in either direction
  • Confirmed memory_promote returns only datapack owners and maintainers are allowed for a contributor, enforced at call time with the tool still listed
  • Confirmed promotion moves rather than copies: memory_search stops returning the item, knowledgebase_search starts, and provenance (agent_id, originating memory_id) survives

Open item

The end-to-end verification above ran on the static-key path. The OAuth authorization leg is written from Meko's advertised OAuth 2.1 support and a successfully registered client, but I have not completed the consent flow start to finish. Reviewers should treat the OAuth steps as unconfirmed until I do, and I will follow up in this PR either way.

🤖 Generated with Claude Code

Meko hosts a remote MCP server for agent memory at mcp.mekodata.ai, built
on YugabyteDB. This adds the connection guide alongside the other remote
MCP server vendors, following the same structure.

Covers the datapack model and the grant levels that decide what a gateway
can reach, OAuth 2.0 setup via Meko's dynamic client registration, the
static-key alternative and why it collapses per-user identity, and a
troubleshooting section for the behaviors that surprise people once a
second person joins a workspace.

Verified against a live gateway with two accounts: 23 tools discovered,
8 exposed through a gateway, called from Claude Code. Promotion, grant
enforcement, and cross-member isolation confirmed end to end.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 2, 2026 7:17pm UTC

Request Review

- Memory is private to the user, attributed to the agent. memory_search
  spans all of that user's agents.
- Every grant sees all 23 tools. Meko denies memory_promote at call time
  rather than hiding it, so the tool list does not vary by grant.
- Any grant can connect and use the memory, conversation, and knowledge
  base tools. Owner or maintainer is needed only for memory_promote.
- Static key: agent_id attribution survives because it is a tool
  argument. What is lost is per-user identity and grants. Keys are
  account-scoped and expire after 365 days.
- Note the default datapack name, the Connect dialog as a second place
  to create keys, and the v2.1.0 removal of tool-level scope arguments.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant