forgetful-mcp-setup
GitHub指导配置 MCP 客户端连接 Forgetful 服务，涵盖 stdio/HTTP 传输、认证授权及连通性验证，确保工具可用。
Trigger Scenarios
Install
npx skills add ScottRBK/forgetful --skill forgetful-mcp-setup -g -y
SKILL.md
Frontmatter
{
"name": "forgetful-mcp-setup",
"tags": [
"mcp",
"setup",
"clients",
"transport",
"auth"
],
"license": "MIT",
"description": "Set up an MCP client for Forgetful — wire Claude Code, Cursor, Copilot, Codex, Gemini, or OpenCode to the server and verify the connection behaves. Covers stdio vs HTTP transport, auth and scopes, the three meta-tools every client sees, and delegation to subagents.",
"allowed-tools": [
"mcp__forgetful__discover_forgetful_tools",
"mcp__forgetful__how_to_use_forgetful_tool",
"mcp__forgetful__execute_forgetful_tool"
],
"disable-model-invocation": true
}
Setting up an MCP client
Every MCP client sees the same three tools fronting the full registry:
discover_forgetful_tools (what exists, by category), how_to_use_forgetful_tool (one
tool's docs and schema), execute_forgetful_tool (invoke by name with a JSON arguments
object). Roughly 500 tokens of surface, with everything else disclosed at runtime.
Pick a transport
- stdio — the client spawns the server per session: command
uvx forgetful-ai(equivalentlyforgetful serve --transport stdio). Right for a personal, local setup. - HTTP — the client connects to a running server at
<server>/mcp, e.g.http://localhost:8020/mcp. Right for a shared or deployed instance.
Claude Code, as the worked example:
claude mcp add forgetful -- uvx forgetful-ai # stdio
claude mcp add --transport http forgetful http://localhost:8020/mcp # HTTP
Other clients follow the same two shapes (spawn command, or HTTP endpoint) in their own
config format — full per-client walkthroughs live in docs/connectivity_guide.md in the
Forgetful repo.
Auth and scopes
A local server defaults to no-auth single-user mode — connect and go. Deployed servers use
bearer tokens or OAuth (the server's configured provider). FORGETFUL_SCOPES on the server
side sets a capability ceiling (e.g. read-only) that both MCP and CLI honour; a client that
should only recall can be scoped so writes are refused.
Verify — the completion criterion
Behavioural, not configurational:
discover_forgetful_toolsreturns categories, and they match the server's enabled feature flags (skills/files/plans appear only when enabled).- One
execute_forgetful_toolround-trip returns real data —get_current_userorlist_projectsboth work as smoke calls.
Done when: both pass in the client that was just wired, in a fresh session.
Delegation boundary
Run Forgetful MCP calls in the main conversation — subagents do not inherit MCP tool
access. When work must be delegated to a subagent, give it the CLI surface instead
(Bash with the forgetful command travels into subagents; see forgetful-cli-setup).
Version History
- 633cc1f Current 2026-07-25 08:21
