MCP Server
Workflows and Scoping
Understand how MCP access maps to OpenSana projects, profiles, and daily workflows.
MCP works best when you keep the OpenSana project, repo path, and client config aligned.
Recommended Workflow
- Save an OpenSana profile for the project.
- Generate MCP config in the same repo or workspace.
- Open the supported AI client from that repo context.
- Use MCP tools against the matching OpenSana project.
Why Scoping Matters
OpenSana is multi-tenant. A correct MCP setup should point at the right:
- deployment URL
- user identity or API key
- project profile
- working directory
If those drift apart, the client may connect successfully but still operate against the wrong project or no project at all.
Best Practices
- keep one clear profile per project or worktree
- prefer project-local config for shared team repos
- document the expected setup in the repo onboarding guide
- regenerate config after major client setup changes
When To Use MCP vs Threads
Use MCP when you want direct tool access from a client.
Use OpenSana threads when you want:
- persistent conversation history in the app
- streamed output back into OpenSana
- task-linked AI work visible to teammates