FAQ & Troubleshooting

Error: Port 4747 Already In Use

If port 4747 is currently occupied by another process, launch OpenBoard on a custom port using the --port flag:

bashCopy
openboard start --port 4848

AI Agent Cannot Connect via MCP

If Claude Code or Cursor reports that the MCP server is unreachable:

1. Ensure the global CLI or npx command is accessible in your shell:

   bashCopy
   which openboard

2. Test stdio initialization directly from terminal:

   bashCopy
   openboard mcp --log-level debug

3. Verify that your agent JSON configuration uses the correct command path:

   jsonCopy
   {
     "mcpServers": {
       "openboard": {
         "command": "npx",
         "args": ["-y", "openboard-app", "mcp"]
       }
     }
   }

SQLite Database Permission Denied

If your user account lacks permissions to write to ~/.openboard:

bashCopy
# Create directory and grant user permissions
mkdir -p ~/.openboard
chmod 700 ~/.openboard