MCP bug: search_documentation fails with Postgres connection error

Date: 2026-03-22

MCP Server: Chipp (build.chipp.ai/mcp, streamable-http transport) MCP Client: Claude Code (Anthropic CLI, macOS)

Steps to reproduce

Call search_documentation with any query:

{ "query": "add_document_source file upload base64" }

Result

{ "error": { "code": "INTERNAL_ERROR", "message": "connect ECONNREFUSED 127.0.0.1:5432" } }

Expected

Returns relevant documentation excerpts.

Root cause evidence

The error connect ECONNREFUSED 127.0.0.1:5432 indicates the documentation search handler is attempting to connect to a PostgreSQL instance on localhost:5432. This suggests the docs search feature uses a local or sidecar Postgres database that is not running in the MCP server's deployed environment.

Other MCP tools that use a different database connection (app CRUD, knowledge sources, custom actions) all work correctly, so this appears to be a database configuration issue specific to the documentation search feature.

Tested twice in the same session — consistently fails with the same error.

Environment

• MCP Server: Chipp (build.chipp.ai/mcp, streamable-http, OAuth 2.0 + PKCE)

• MCP Client: Claude Code (Anthropic CLI, macOS darwin)

• All other MCP tools (app management, knowledge sources, custom actions, system prompt, branding) function normally for this workspace and app.