Connection guide
Config
Runtime URLs for MCP clients, REST clients, OAuth discovery, health, public config, and operator logs.
Base URL
Effective source: app base url
https://mcp.minasoftai.comAPP_BASE_URL is set and controls generated MCP, REST, OAuth discovery, and curl URLs.
Connection URLs
MCP unified
https://mcp.minasoftai.com/mcpMCP no auth
https://mcp.minasoftai.com/mcp/noneMCP Basic
https://mcp.minasoftai.com/mcp/basicMCP OAuth bearer
https://mcp.minasoftai.com/mcp/oauthSSE no auth
https://mcp.minasoftai.com/sse/noneSSE Basic
https://mcp.minasoftai.com/sse/basicSSE OAuth bearer
https://mcp.minasoftai.com/sse/oauthREST tools
https://mcp.minasoftai.com/rest/toolsREST call
https://mcp.minasoftai.com/rest/tools/{tool_name}/callOAuth protected resource
https://mcp.minasoftai.com/.well-known/oauth-protected-resourceOAuth authorization server
https://mcp.minasoftai.com/.well-known/oauth-authorization-serverOpenID configuration
https://mcp.minasoftai.com/.well-known/openid-configurationOAuth JWKS
https://mcp.minasoftai.com/oauth/jwksVerification hub
Client config, curl examples, and OAuth preparation steps now live in the focused Inspector flow.
Operator logs
- Command
LOG_LEVEL=info npm run start:logged- Directory
- logs/
- Levels
- trace, debug, info, warn, error
- Runtime counts
- 2/2 tools enabled, 8 OAuth clients, 9 issued tokens
TLS for local tests
Nginx TLS termination is still recommended for public deployments. Built-in HTTPS is for local client tests.
- Generate localhost cert
npm run cert:dev- Start HTTPS
TLS_CERT_FILE=certs/localhost-cert.pem TLS_KEY_FILE=certs/localhost-key.pem PORT=3443 npm run start:tls- Start HTTPS with logs
TLS_CERT_FILE=certs/localhost-cert.pem TLS_KEY_FILE=certs/localhost-key.pem PORT=3443 npm run start:logged- TLS smoke
npm run start:tls:smoke- HTTPS inspector
npm run inspector:mock -- --base-url https://127.0.0.1:3443 --insecure-tls- Configured inputs
- cert missing, key missing