docs: add comprehensive MCP creation guide

[JonasJesus42]

• Document two authentication patterns: OAuth and API Key/Token
• Include complete code examples for both patterns
• Add mermaid diagrams explaining auth flows
• Cover directory structure, tools creation, app.json config
• Include troubleshooting section and examples references

Examples covered:

• OAuth: Google Drive, Gmail, Sheets, OpenRouter
• API Key: Meta Ads, Perplexity, Pinecone

---

Summary by cubic

Adds a comprehensive guide for building MCP servers with OAuth and API key authentication, including complete examples, flow diagrams, and setup instructions. Helps developers scaffold, configure, and troubleshoot MCPs end to end.

• New Features
  • New CREATING_MCP_GUIDE.md with quick start, directory structure, and package/tsconfig templates.
  • Auth patterns: OAuth (Google/OpenRouter) and API key, with mermaid flow diagrams and full code samples, including token/key helpers.
  • Tool creation patterns and exports.
  • Registry app.json setup, workspace addition, deployment steps, and required environment variables.
  • Troubleshooting and example references (Google Drive/Sheets/Gmail/OpenRouter; Meta Ads/Perplexity/Pinecone).

^{Written for commit 5420d36. Summary will update on new commits.}

[cubic-dev-ai]

1 issue found across 1 file

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="CREATING_MCP_GUIDE.md">

<violation number="1" location="CREATING_MCP_GUIDE.md:334">
P2: The Simple OAuth example uses `DefaultEnv` without importing it, so the snippet as written will not compile.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P2: The Simple OAuth example uses DefaultEnv without importing it, so the snippet as written will not compile.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At CREATING_MCP_GUIDE.md, line 334:

<comment>The Simple OAuth example uses `DefaultEnv` without importing it, so the snippet as written will not compile.</comment>

<file context>
@@ -0,0 +1,607 @@
+
+const StateSchema = z.object({});
+
+export type Env = DefaultEnv<typeof StateSchema>;
+
+const runtime = withRuntime<Env, typeof StateSchema>({
</file context>

Suggested change

	export type Env = DefaultEnv<typeof StateSchema>;
	import { DefaultEnv, withRuntime } from "@decocms/runtime";