MCP Server

Connect and Configure

Generate MCP configuration for supported clients and bind it to the right OpenSana project.

The simplest path is to use opensana init mcp.

Generate Config

opensana init mcp
opensana init mcp --cli claude
opensana init mcp --cli codex

This writes client-specific config files such as:

.mcp.json
.codex/config.toml

Prerequisites

Before generating MCP config, make sure you have:

run opensana setup
selected the correct project profile
created an API key if your flow requires one

Project vs User Scope

Think about config scope before writing files:

use project scope when the config should travel with the repo
use user scope when the config is machine-specific

Verify the Result

After generation:

Inspect the written config file.
Confirm the target client sees the MCP server.
Test basic operations such as listing or reading tasks.

Introduction

Use MCP to expose OpenSana tasks and project context to supported AI clients.

Workflows and Scoping

Understand how MCP access maps to OpenSana projects, profiles, and daily workflows.

On this page

Generate Config Prerequisites Project vs User Scope Verify the Result Related Pages