fix(seo): canonical self-deindexing on /docs/*, truthful llms.txt, real sitemap dates, RSS feed, breadcrumbs, per-article OG images
- /docs subpages canonicalized to /docs and had no descriptions; each now uses pageMetadata with its own path (was: Google could index at most one) - llms.txt claimed Team EUR 149, RBAC/SLA and BYO-cloud that do not exist; regenerated from lib/seo.ts truth + new llms-full.txt with docs content - sitemap stamped lastModified=now on every request; now real per-route dates from new lib/articles.ts registry (single source for guides index/sitemap/RSS) - new /feed.xml RSS 2.0 route + alternates link in root layout - articleJsonLd: image (per-guide opengraph-image via lib/og-article.tsx), Person author, wordCount; new breadcrumbJsonLd on guides + docs - GSC verification via NEXT_PUBLIC_GSC_VERIFICATION (documented in .env.example) - dropped fabricated Enterprise EUR 499 offer from SoftwareApplication JSON-LD - article-shell: OL/Table/Note primitives for upcoming articles Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SXUwmPVRTD8AKQtio6gCN5
This commit is contained in:
@@ -71,3 +71,33 @@ export function UL({ children }: { children: ReactNode }) {
|
||||
export function Strong({ children }: { children: ReactNode }) {
|
||||
return <strong className="font-semibold text-[--color-fg]">{children}</strong>;
|
||||
}
|
||||
|
||||
export function OL({ children }: { children: ReactNode }) {
|
||||
return (
|
||||
<ol className="mt-3 list-decimal space-y-1.5 pl-5 text-[14.5px] leading-relaxed text-[--color-fg-muted]">
|
||||
{children}
|
||||
</ol>
|
||||
);
|
||||
}
|
||||
|
||||
/** Comparison / feature tables. Pass fully-formed <thead>/<tbody> children;
|
||||
* the wrapper provides the horizontal-scroll container so wide tables never
|
||||
* break the mobile viewport. */
|
||||
export function Table({ children }: { children: ReactNode }) {
|
||||
return (
|
||||
<div className="mt-4 overflow-x-auto rounded-lg border border-[--color-border]">
|
||||
<table className="w-full min-w-[560px] border-collapse text-left text-[13.5px] leading-relaxed [&_td]:border-t [&_td]:border-[--color-border] [&_td]:px-3.5 [&_td]:py-2.5 [&_td]:align-top [&_td]:text-[--color-fg-muted] [&_th]:bg-[--color-bg-subtle] [&_th]:px-3.5 [&_th]:py-2.5 [&_th]:text-[12px] [&_th]:font-semibold [&_th]:uppercase [&_th]:tracking-wider [&_th]:text-[--color-fg]">
|
||||
{children}
|
||||
</table>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
/** Callout for caveats and version-sensitive facts. */
|
||||
export function Note({ children }: { children: ReactNode }) {
|
||||
return (
|
||||
<div className="mt-4 rounded-lg border border-[--color-border] bg-[--color-bg-subtle] px-4 py-3 text-[13.5px] leading-relaxed text-[--color-fg-muted]">
|
||||
{children}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
import { articleOgImage, OG_SIZE } from '@/lib/og-article';
|
||||
|
||||
export const runtime = 'edge';
|
||||
export const alt = 'How to host a remote MCP server with OAuth (2026)';
|
||||
export const size = OG_SIZE;
|
||||
export const contentType = 'image/png';
|
||||
|
||||
export default function Image() {
|
||||
return articleOgImage({
|
||||
title: 'How to host a remote MCP server with OAuth (2026)',
|
||||
tag: 'Guide',
|
||||
});
|
||||
}
|
||||
@@ -1,5 +1,5 @@
|
||||
import { JsonLd } from '@/components/json-ld';
|
||||
import { articleJsonLd, pageMetadata } from '@/lib/seo';
|
||||
import { articleJsonLd, breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
|
||||
import Link from 'next/link';
|
||||
import { ArticleShell, H2, P, Strong, UL } from '../article-shell';
|
||||
|
||||
@@ -21,6 +21,13 @@ export default function Page() {
|
||||
datePublished: '2026-05-31',
|
||||
})}
|
||||
/>
|
||||
<JsonLd
|
||||
data={breadcrumbJsonLd([
|
||||
{ name: 'Home', path: '/' },
|
||||
{ name: 'Guides', path: '/guides' },
|
||||
{ name: TITLE, path: PATH },
|
||||
])}
|
||||
/>
|
||||
<ArticleShell
|
||||
title={TITLE}
|
||||
subtitle="Local STDIO servers are easy. A remote MCP server that Claude, Cursor and ChatGPT can install over the internet — without leaving it open to the world — is where the real work is. Here's the whole picture."
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
import { articleOgImage, OG_SIZE } from '@/lib/og-article';
|
||||
|
||||
export const runtime = 'edge';
|
||||
export const alt = 'Hosted MCP platforms compared: Cloudflare, Smithery, Composio & generating your own';
|
||||
export const size = OG_SIZE;
|
||||
export const contentType = 'image/png';
|
||||
|
||||
export default function Image() {
|
||||
return articleOgImage({
|
||||
title: 'Hosted MCP platforms compared: Cloudflare, Smithery, Composio & more',
|
||||
tag: 'Comparison',
|
||||
});
|
||||
}
|
||||
@@ -1,5 +1,5 @@
|
||||
import { JsonLd } from '@/components/json-ld';
|
||||
import { articleJsonLd, pageMetadata } from '@/lib/seo';
|
||||
import { articleJsonLd, breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
|
||||
import Link from 'next/link';
|
||||
import { ArticleShell, H2, P, Strong, UL } from '../article-shell';
|
||||
|
||||
@@ -22,6 +22,13 @@ export default function Page() {
|
||||
datePublished: '2026-05-31',
|
||||
})}
|
||||
/>
|
||||
<JsonLd
|
||||
data={breadcrumbJsonLd([
|
||||
{ name: 'Home', path: '/' },
|
||||
{ name: 'Guides', path: '/guides' },
|
||||
{ name: TITLE, path: PATH },
|
||||
])}
|
||||
/>
|
||||
<ArticleShell
|
||||
title={TITLE}
|
||||
subtitle="There are 14,000+ MCP servers out there and a dozen platforms claiming to host them. They are not competing for the same job. Sort them into four buckets and the choice gets obvious."
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
import { articleOgImage, OG_SIZE } from '@/lib/og-article';
|
||||
|
||||
export const runtime = 'edge';
|
||||
export const alt = 'MintMCP alternative: generate and host a custom MCP server';
|
||||
export const size = OG_SIZE;
|
||||
export const contentType = 'image/png';
|
||||
|
||||
export default function Image() {
|
||||
return articleOgImage({
|
||||
title: 'MintMCP alternative: generate and host a custom MCP server',
|
||||
tag: 'Alternative',
|
||||
});
|
||||
}
|
||||
@@ -1,5 +1,5 @@
|
||||
import { JsonLd } from '@/components/json-ld';
|
||||
import { articleJsonLd, pageMetadata } from '@/lib/seo';
|
||||
import { articleJsonLd, breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
|
||||
import Link from 'next/link';
|
||||
import { ArticleShell, H2, P, Strong, UL } from '../article-shell';
|
||||
|
||||
@@ -21,6 +21,13 @@ export default function Page() {
|
||||
datePublished: '2026-05-31',
|
||||
})}
|
||||
/>
|
||||
<JsonLd
|
||||
data={breadcrumbJsonLd([
|
||||
{ name: 'Home', path: '/' },
|
||||
{ name: 'Guides', path: '/guides' },
|
||||
{ name: TITLE, path: PATH },
|
||||
])}
|
||||
/>
|
||||
<ArticleShell
|
||||
title={TITLE}
|
||||
subtitle="MintMCP and BuildMyMCPServer both get you to a hosted, OAuth-protected MCP server — but they start from opposite ends. The right pick depends entirely on whether you already have server code."
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
import { pageMetadata } from '@/lib/seo';
|
||||
import { JsonLd } from '@/components/json-ld';
|
||||
import { articlesNewestFirst } from '@/lib/articles';
|
||||
import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
|
||||
import Link from 'next/link';
|
||||
|
||||
export const metadata = pageMetadata({
|
||||
@@ -8,48 +10,40 @@ export const metadata = pageMetadata({
|
||||
path: '/guides',
|
||||
});
|
||||
|
||||
const GUIDES = [
|
||||
{
|
||||
slug: 'host-mcp-server-with-oauth',
|
||||
title: 'How to host a remote MCP server with OAuth (2026)',
|
||||
description:
|
||||
'Streamable HTTP, OAuth 2.1, PKCE and Resource Indicators — what it actually takes to put a remote MCP server in production, and the shortcuts.',
|
||||
tag: 'Guide',
|
||||
},
|
||||
{
|
||||
slug: 'hosted-mcp-platforms-compared',
|
||||
title: 'Hosted MCP platforms compared: Cloudflare, Smithery, Composio & generating your own',
|
||||
description:
|
||||
'The MCP hosting landscape splits into four categories. Which one fits depends on whether you have a server already, need a catalog, or need bespoke logic.',
|
||||
tag: 'Comparison',
|
||||
},
|
||||
{
|
||||
slug: 'mintmcp-alternative',
|
||||
title: 'MintMCP alternative: generate and host a custom MCP server',
|
||||
description:
|
||||
'MintMCP wraps an existing STDIO server into a remote one. If you do not have a server yet, here is the generate-from-a-prompt route — and where MintMCP still wins.',
|
||||
tag: 'Alternative',
|
||||
},
|
||||
];
|
||||
|
||||
export default function GuidesIndex() {
|
||||
const guides = articlesNewestFirst();
|
||||
return (
|
||||
<div className="mx-auto max-w-3xl px-6 py-14">
|
||||
<JsonLd
|
||||
data={breadcrumbJsonLd([
|
||||
{ name: 'Home', path: '/' },
|
||||
{ name: 'Guides', path: '/guides' },
|
||||
])}
|
||||
/>
|
||||
<h1 className="text-[28px] font-semibold tracking-tight text-[--color-fg]">MCP guides</h1>
|
||||
<p className="mt-2 text-[14.5px] leading-relaxed text-[--color-fg-muted]">
|
||||
Hosting, auth and shipping for Model Context Protocol servers — written for people building
|
||||
real tools, not demos.
|
||||
</p>
|
||||
<div className="mt-8 space-y-3">
|
||||
{GUIDES.map((g) => (
|
||||
{guides.map((g) => (
|
||||
<Link
|
||||
key={g.slug}
|
||||
href={`/guides/${g.slug}`}
|
||||
className="block rounded-lg border border-[--color-border] p-4 transition-colors hover:bg-[--color-bg-subtle]"
|
||||
>
|
||||
<span className="mono text-[10.5px] uppercase tracking-wider text-[--color-fg-subtle]">
|
||||
{g.tag}
|
||||
</span>
|
||||
<div className="flex items-center gap-2.5">
|
||||
<span className="mono text-[10.5px] uppercase tracking-wider text-[--color-fg-subtle]">
|
||||
{g.tag}
|
||||
</span>
|
||||
<span className="text-[10.5px] text-[--color-fg-subtle]">
|
||||
{new Date(g.dateModified ?? g.datePublished).toLocaleDateString('en-US', {
|
||||
year: 'numeric',
|
||||
month: 'short',
|
||||
day: 'numeric',
|
||||
})}
|
||||
</span>
|
||||
</div>
|
||||
<h2 className="mt-1 text-[16px] font-semibold tracking-tight text-[--color-fg]">
|
||||
{g.title}
|
||||
</h2>
|
||||
|
||||
Reference in New Issue
Block a user