Help & Support

We're Here
to Help

Hardware issues, bridge errors, AI integration questions — reach us through the channel that works best for you.

Contact Channels
🐛
GitHub Issues
Bug reports, feature requests, and firmware issues. Fastest response for technical problems.
Open an Issue →
📧
Email Support
For order inquiries, B2B questions, and issues not suited for public GitHub threads.
starinvc@gmail.com →
🛒
User Store Help
Order status, shipping, returns, and purchase-related questions via the Pclika store.
hc.pclika.com →
📖
Documentation
Developer Guide, MCP tool reference, quickstart, and troubleshooting in five languages.
Browse Docs →
⬇️
Downloads
Firmware binaries, bridge releases, PDF guides, hardware schematics, and example projects.
Go to Downloads →
🤖
MCP Self-Service
Connect Claude directly to your Pclika hardware via the MCP channel — one command setup.
Quick Connect →
All Systems
Operational — PyPI pclika-bridge · GitHub Releases · Documentation · Store

For real-time status updates follow GitHub Releases. Critical issues are announced there first.

Quick Connect

Run three commands and Claude (or Cursor / VS Code) will have live access to your Pclika hardware.

1. Install bridge
pip install pclika-bridge
2. Start SSE server
pclika-bridge --port /dev/ttyUSB0 --serve # default: localhost:3141
3. Register with Claude Code
claude mcp add pclikaPlatform --transport sse http://localhost:3141/sse

After registration, restart Claude Code. The pclikaPlatform MCP server will appear in the tool list — type "read temperature sensor" and Claude talks to your hardware directly.

⬇ Claude Desktop Config ⬇ Cursor Config ⬇ VS Code Config
FAQ
Bridge can't find serial port
On Linux add your user to the dialout group: sudo usermod -aG dialout $USER then log out and back in. On macOS the port is typically /dev/tty.usbserial-* — run ls /dev/tty.* to find it. On Windows use Device Manager → Ports (COM & LPT) to identify the COM port, then pass --port COM3.
Claude doesn't see the pclikaPlatform MCP tools
Make sure the SSE server is running first (pclika-bridge --serve), then restart Claude Code after running claude mcp add. You can verify registration with claude mcp list. If the server is listed but tools don't appear, check that http://localhost:3141/sse is reachable in your browser.
Firmware flash fails or board not detected
Hold the BOOT button on the ESP32-S3 while connecting USB, then run idf.py flash. If esptool.py still times out, try a different USB cable (data-capable, not charge-only) and a direct port on your machine — USB hubs can cause issues.
sensor_read returns "timeout" or stale data
Check the sensor wiring against the schematic in Downloads → Schematics. The I²C bus needs pull-up resistors (4.7 kΩ to 3.3 V). Run sensor_read(sensor_id="ping") first — if that times out the bridge–board serial link itself has an issue.
How do I update the firmware without re-flashing everything?
Use OTA mode: run pclika-bridge ota --version latest while the board is connected via serial. The bridge downloads the latest release from GitHub Releases, verifies the SHA-256 checksum, and writes only the app partition. Total downtime is under 30 seconds.
Can I use Pclika with Cursor or VS Code instead of Claude Code?
Yes. Download the config file for your editor above, merge it into your editor's MCP settings JSON, and start the SSE server. Cursor uses .cursor/mcp.json; VS Code (with the MCP extension) uses .vscode/mcp.json. The MCP protocol is editor-agnostic.
Where are the Developer Guide PDFs in other languages?
Go to Downloads → Developer Guides. PDFs are available in English, 中文, Русский, Français, and Deutsch — all downloadable from GitHub Releases.
Before You Report

Run these commands and include the output in your GitHub Issue or email — it cuts resolution time significantly.

# Bridge version and serial port scan pclika-bridge --version pclika-bridge --list-ports # Test connection to board pclika-bridge --port /dev/ttyUSB0 --ping # MCP registration check (Claude Code) claude mcp list # Python environment python --version pip show pclika-bridge
Submit a Ticket

For non-public issues (orders, hardware defects, licensing). We respond within 2 business days.