You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: simplify default docker config; move project mount to advanced section
Remove -v workspaceFolder and -e AGENT_CONFIG_DIR from Options A and B.
Server runs in schema-free mode by default — project mount is only needed
for custom note schemas. Add Advanced section explaining the project mount
should only appear in per-project .mcp.json (Option B), not global
registrations (Option A), to avoid per-project schema bleed on shared configs.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+25-4Lines changed: 25 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -74,8 +74,6 @@ claude mcp add-json mcp-task-orchestrator '{
74
74
"args": [
75
75
"run", "--rm", "-i",
76
76
"-v", "mcp-task-data:/app/data",
77
-
"-v", "${workspaceFolder}:/project:ro",
78
-
"-e", "AGENT_CONFIG_DIR=/project",
79
77
"ghcr.io/jpicklyk/task-orchestrator:latest"
80
78
]
81
79
}'
@@ -95,8 +93,6 @@ Add to `.mcp.json` in your project root (checked into source control so teammate
95
93
"args": [
96
94
"run", "--rm", "-i",
97
95
"-v", "mcp-task-data:/app/data",
98
-
"-v", "${workspaceFolder}:/project:ro",
99
-
"-e", "AGENT_CONFIG_DIR=/project",
100
96
"ghcr.io/jpicklyk/task-orchestrator:latest"
101
97
]
102
98
}
@@ -110,6 +106,31 @@ The `mcp-task-data` Docker volume persists the SQLite database across container
110
106
111
107
Configure your client with the same JSON as Option A above. STDIO transport works with any MCP-compatible client.
112
108
109
+
### Advanced: Per-Project Note Schemas
110
+
111
+
By default the server runs in schema-free mode — all 13 tools work with no additional configuration. If you want to define custom note schemas that gate role transitions (e.g., require an acceptance-criteria note before a work item can advance), you can point the server at your project's `.taskorchestrator/config.yaml`.
112
+
113
+
Add the project mount to your **Option B**`.mcp.json` only (not the global Option A registration — a globally-registered server should not have its schema config vary per project):
114
+
115
+
```json
116
+
{
117
+
"mcpServers": {
118
+
"mcp-task-orchestrator": {
119
+
"command": "docker",
120
+
"args": [
121
+
"run", "--rm", "-i",
122
+
"-v", "mcp-task-data:/app/data",
123
+
"-v", "${workspaceFolder}:/project:ro",
124
+
"-e", "AGENT_CONFIG_DIR=/project",
125
+
"ghcr.io/jpicklyk/task-orchestrator:latest"
126
+
]
127
+
}
128
+
}
129
+
}
130
+
```
131
+
132
+
See [Workflow Guide](current/docs/workflow-guide.md) for the `.taskorchestrator/config.yaml` schema format and examples.
133
+
113
134
### Step 3: Claude Code Plugin (optional)
114
135
115
136
Install the plugin for workflow skills, session-start hooks, and an orchestrator output style:
0 commit comments