Skip to content

AI Assistant Guide

This is a concise guide for any AI agent or MCP client that interacts with Partle.

MCP tools still experimental

The MCP servers, ChatGPT integration, and other AI tooling are being prototyped. Validate every workflow manually before relying on automated interactions.

Ground rules

  • Single production database, reachable only over the loopback: 127.0.0.1:5432 on the Hetzner box, or 127.0.0.1:5433 elsewhere after ssh -N hetzner-db &. The public IP 91.98.68.236:5432 is firewalled and times out from every machine. Never create or migrate against local databases unless explicitly told.
  • Secrets live in per-service .env files (backend/.env, frontend/.env). Do not invent new environment variables without approval.
  • Authentication UX: one combined login/signup endpoint (/v1/auth/login). Never add separate pages or flows.
  • Ports: frontend dev on 3000, backend on 8000, Postgres 5432.

Assisted workflows

  • Trigger the React search bar and layout only from Layout.tsx (one global instance).
  • SearchBar controls are fixed at top; mobile vs. desktop components should not be duplicated.
  • When building scripts/tests, run npm run build for the frontend and uv run python -c "from app.main import app" for backend sanity checks.

Incident response

  • Credential exposure requires immediate rotation and notification. Last incident: 2025‑09‑05 when backend/downloaded_server.env was committed.

MCP / AI integrations

  • Remote MCP server at https://partle.rubenayla.xyz/mcp/ (Streamable HTTP, MCP spec 2025-06-18).
  • Discovery manifest: https://partle.rubenayla.xyz/.well-known/mcp.json.
  • Per-client setup: see docs/mcp-setup.md (published at /documentation/mcp-setup/).

🛈 Repository contributors must also follow the complete instructions supplied with their working copy; this page is only a concise reference.