constellation-troubleshootinglisted
Install: claude install-skill ShiftinBits/constellation-claude
# Constellation Troubleshooting
Quick diagnostic procedures for Constellation plugin issues.
## Quick Diagnosis Flowchart
```
Issue Reported
|
v
Can mcp__constellation__code_intel be called?
| |
YES NO
| |
v v
API Error MCP Server Issue
(has code) (see MCP Diagnosis)
|
v
Check error.code:
- AUTH_ERROR --> Authentication section
- PROJECT_NOT_INDEXED --> Indexing section
- SYMBOL_NOT_FOUND --> Query Issues section
- API_UNREACHABLE --> Connectivity section
```
## MCP Server Issues
**Symptom:** "Failed to reconnect to plugin:constellation:constellation" or tool calls fail entirely.
**Cause:** The MCP server isn't starting or is crashing.
**Quick Fixes:**
1. **Restart Claude Code** - MCP connections initialize at startup
2. **Verify MCP configuration:**
Note, the tool is built into the constellation plugin, but should accurately reflect the following:
```json
{
"mcpServers": {
"constellation": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@constellationdev/mcp@latest"],
"env": {
"CONSTELLATION_ACCESS_KEY": "${CONSTELLATION_ACCESS_KEY}"
}
}
}
}
```
## Authentication Issues (AUTH_ERROR)
**Symptom:** "Authentication failed" or "Invalid API key"
**Quick Fixes:**
1. **Configure credentials:**
```bash
npx @constellationdev/cli auth