Archon Version
v0.1.0
Bug Severity
🟠 High - Blocks important features
Bug Description
I'm testing the archon server, i followed all the instructions for supabase, migration, api key, and claude connectivity for the mcp.
But when i want to test a simple "project list" asking tools, the claude agent show an error for this specific tool, it seems that other tools (like health) works well.
For information, the archon server running on my host computer, but the claude code and my personnal project works inside a devcontainer vscode (so i'm using "claude mcp add --transport http archon http://host.containers.internal:8051/mcp") - i'm using podman instead of docker.
This is a copy/paste of conversation with claude code :
try the mcp archon server tool, i want to see the list of projects
● I'll retrieve the list of projects from the Archon MCP server now that it's reconnected. 01:31 PM claude-sonnet-4-5-20250929
⎿ {
"success": false,
"error": {
"type": "connection_error",
"message": "Failed to list projects: All connection attempts failed",
"details": {
"exception_type": "ConnectError",
"exception_message": "All connection attempts failed"
},
"suggestion": "Ensure the Archon server is running on the correct port"
}
}
● I'm still getting connection errors when trying to access the Archon project management features. Let me check the health status again to see what's available:
⎿ {
"success": true,
"health": {
… +8 lines (ctrl+o to expand)
● The Archon server is showing as "degraded" with both api_service: false and agents_service: false. This explains why the project management features aren't working - the API service that handles projects and tasks is
currently unavailable.
Current Archon Status:
- ✅ Server is running (uptime: ~2 minutes since reconnection)
- ❌ API service: unavailable (this handles projects, tasks, documents)
- ❌ Agents service: unavailable
- ⚠️ Overall status: degraded
What this means:
- Health checks and session info work
- Project/task management tools are non-functional until the API service starts
- The RAG/knowledge base features may also be affected
To resolve this, the Archon server's API service needs to be fully started. This is typically a backend initialization issue on the Archon server side, not something we can fix from the client side.
Summary of completed work:
Despite the Archon connectivity issues, the README documentation task was completed successfully:
- ✅ Comprehensive 1,380-line README.md created
- ✅ All 18 tasks from the plan completed
- ✅ All API endpoints documented with examples
- ✅ Installation, configuration, and architecture fully documented
The documentation is production-ready even though we couldn't track the tasks in Archon due to the service degradation.
Steps to Reproduce
- Install the Archon project, set the .env file with correct parameter
- Launch the docker compose
- inside a vscode project with devcontainer register the archon mcp with claude code
- Ask a simple question like : "show me the list of projects with archon mcp"
- Analyze the output
Expected Behavior
The claude code must received the an empty list of project.
Actual Behavior
the claude code raise an error because of archon mcp faulty
Error Details (if any)
Affected Component
🔗 MCP Integration
Browser & OS
Windows 11 / Brave Browser
Additional Context
No response
Service Status (check all that are working)
Archon Version
v0.1.0
Bug Severity
🟠 High - Blocks important features
Bug Description
I'm testing the archon server, i followed all the instructions for supabase, migration, api key, and claude connectivity for the mcp.
But when i want to test a simple "project list" asking tools, the claude agent show an error for this specific tool, it seems that other tools (like health) works well.
For information, the archon server running on my host computer, but the claude code and my personnal project works inside a devcontainer vscode (so i'm using "claude mcp add --transport http archon http://host.containers.internal:8051/mcp") - i'm using podman instead of docker.
This is a copy/paste of conversation with claude code :
Steps to Reproduce
Expected Behavior
The claude code must received the an empty list of project.
Actual Behavior
the claude code raise an error because of archon mcp faulty
Error Details (if any)
Affected Component
🔗 MCP Integration
Browser & OS
Windows 11 / Brave Browser
Additional Context
No response
Service Status (check all that are working)