Agent setup

Teach any AI workspace how to use Edith.

This marketing page is the canonical setup guide. The live MCP endpoint, OAuth metadata, tool schemas, and hosted workflow skills are app-domain contracts on https://app.edithmd.com, so agents should use those URLs as source of truth.

Guidance

Read setup instructions here on edithmd.com.

Live tools

Fetch MCP tools and skills from app.edithmd.com.

Safety

Ask before login, tokens, scopes, or destructive changes.

Copy prompt

Start agent setup safely.

Paste this into an AI workspace.

Set up Edith for this workspace.

Edith is my AI-native Markdown workspace for files, assets, versions, review links, share links, comments, suggestions, and feedback workflows.

Read https://edithmd.com/ai/agent for setup guidance. Treat https://app.edithmd.com as the source of truth for live Edith MCP, OAuth, tool schemas, and hosted skills. Fetch tool docs from https://app.edithmd.com/ai/mcp-tools and the skill catalogue from https://app.edithmd.com/ai/skills/catalog.json. Ask me before writing config or making any login or token step. Connect Edith MCP at https://app.edithmd.com/mcp if this environment supports it.
Open Edith

What the agent should do

  • Use this page for setup policy and product context.
  • Use https://app.edithmd.com for live MCP contracts because tools and skills change with the app.
  • Fetch tool docs from https://app.edithmd.com/ai/mcp-tools and machine-readable tools from https://app.edithmd.com/ai/mcp-tools.json.
  • Fetch hosted skills from https://app.edithmd.com/ai/skills/catalog.json; install Markdown skills directly where supported, or adapt them into the client's required skill folder, manifest, plugin, or prompt format.
  • Connect MCP at https://app.edithmd.com/mcp. Discover OAuth from https://app.edithmd.com/.well-known/oauth-authorization-server and protected-resource metadata from https://app.edithmd.com/.well-known/oauth-protected-resource/mcp.
  • Before OAuth authentication starts, explain the exact Edith MCP scopes you plan to request and ask the user to choose or approve them.
  • Verify access by calling MCP tools/list before claiming setup is complete.

Canonical app URLs

The marketing-domain paths redirect for compatibility, but agents should persist and cite the app-domain URLs.

Claude Claude Code OpenCode Codex ChatGPT Gemini OpenAI Claude Claude Code OpenCode Codex ChatGPT Gemini OpenAI