Author

Powerduck

4 min read

MCP stdio vs Remote Transports: Run It Locally or Host It?

The same MCP server can run over stdio on a laptop or Streamable HTTP behind a domain, and the choice changes auth, state, latency, and who can use it. Here is a decision framework with the actual launch commands and client config for each transport.

Read article
4 min read

MCP Authentication Explained: OAuth 2.1 for Remote MCP Servers

Local stdio MCP servers inherit your CLI credentials, so nobody notices auth until they host one. Remote MCP servers require OAuth 2.1 with PKCE, metadata discovery, and short-lived tokens. Here is the full flow and the mistakes that get servers rejected by clients.

Read article
4 min read

Connect Cursor and Claude Code to your internal API over MCP (step by step)

Stop pasting internal API docs into every agent session. Serve the OpenAPI spec as a local or hosted MCP endpoint, register it once in Cursor and Claude Code, and let the agent call typed tools. Here is the full setup, auth scoping, and the verification checklist.

Read article
4 min read

Generate code from the spec, not the spec from the code

Agents guess field names when they never see the contract. Serve the spec over MCP, generate one verified vertical slice at a time, run scenarios against localhost, and rescan to catch drift.

Read article
3 min read

Designing an API before the first line of code

Behavior first, routes second. AI drafts the OpenAPI contract as reviewable diffs, the team settles money, idempotency, and error envelopes up front, and mocks plus scenarios define done before implementation starts.

Read article
2 min read

Publishing partner API docs shouldn't become a website project

Integration is done and the partner asks for a link. Finish descriptions locally, verify real calls, and publish versioned hosted docs and MCP from the same workspace, with no doc-tool rollout attached.

Read article
4 min read

Publish API docs and an MCP endpoint from one spec with a custom domain

Docs, mock, and MCP endpoint usually mean three pipelines, three versions, and three sources of drift. Here is how to publish human docs and an agent endpoint from one OpenAPI document on your own domain, with access control, versioning, and a rollback path.

Read article
4 min read

MCP vs function calling vs ChatGPT plugins: what API teams actually need in 2026

Function calling is a model capability; plugins were a ChatGPT-era distribution experiment; MCP is a transport and discovery protocol between clients and tool servers. They are not competitors, and confusing them produces bad integrations. Here is the layered view and where your OpenAPI spec fits.

Read article