{
 "schema_version": 1,
 "generated": "2026-11-01",
 "id": "saltmd-salt-md--connect-agent-to-workspace",
 "repo": "saltmd/salt.md",
 "repo_url": "https://github.com/saltmd/salt.md",
 "repo_slug": "saltmd-salt-md",
 "title": "Let an AI agent work in your workspace via MCP",
 "page_title": "How to let an AI agent work in your workspace via MCP with Salt",
 "summary": "Point Claude, Cursor or another MCP client at /mcp so it edits pages and databases.",
 "who": "A knowledge worker whose team already runs Salt and who wants an AI assistant to create and update pages and rows on their behalf.",
 "problem": "Copying content between an AI chat and the workspace by hand is slow and error prone.",
 "outcome": "An MCP client connected to your instance's /mcp endpoint that can create pages, add database rows and search, on your own access level.",
 "steps": [
  "Make sure the instance is running and note its base address, then append /mcp to it.",
  "Add that /mcp address as an MCP server in your client, such as Claude, ChatGPT, Codex, Cursor or Gemini CLI.",
  "Authenticate the client with the access you want it to have. An agent's credential carries your person's access and never more.",
  "Ask the agent to create a page, then open the workspace to confirm it appears with the same history as your own edits."
 ],
 "agent_prompt": "Using the salt.md repo at https://github.com/saltmd/salt.md, connect this MCP client to the /mcp endpoint of <instance-url>. Create a test page titled <page-title> and confirm it appears in the workspace and in the activity log.",
 "agents": [
  "claude-code",
  "codex",
  "cursor",
  "gemini-cli"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The README says agents cannot create or delete accounts, issue tokens, take backups, change instance settings or decide workspace membership, so do those steps yourself.",
 "category": "Work and operations",
 "tags": [
  "Work and operations"
 ],
 "lang": "typescript",
 "requirements": [
  "A Linux, macOS or Windows machine or server to run the binary, or a machine with Docker",
  "A web browser to open the address the installer prints",
  "An MCP-capable client such as Claude, ChatGPT, Codex, Cursor or Gemini CLI, if you want agents to work in the workspace",
  "Files to import (Markdown, CSV or a Notion export), if you are migrating content"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The MCP client holds a credential for your account, so treat its token as you would a password and only add clients you trust."
  }
 ],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/saltmd-salt-md/connect-agent-to-workspace/",
 "md": "https://dedupedai.com/use-cases/saltmd-salt-md/connect-agent-to-workspace/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/saltmd-salt-md--connect-agent-to-workspace.json",
 "api_version": "v1"
}