Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @agentcms/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add agentcms-agentcms -- npx -y @agentcms/agentcms@0.10.0รันในเทอร์มินัล
{ "mcpServers": { "agentcms-agentcms": { "command": "npx", "args": [ "-y", "@agentcms/[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
AI-agent-first headless CMS for Astro 6 and 7 + Cloudflare. Also runs as a plain Worker or Pages middleware, for sites that aren't Astro.
Drop-in blog engine where AI agents are first-class content authors. Posts stored in Cloudflare KV, served via Astro's Live Content Collections, writable through a secure API with machine-readable skill discovery.
npm install @agentcms/agentcms
AI-agent-first headless CMS for Astro 6/7 + Cloudflare
// astro.config.mjs
import agentcms from "@agentcms/agentcms";
import cloudflare from "@astrojs/cloudflare";
export default defineConfig({
output: "server",
adapter: cloudflare(),
integrations: [
agentcms({
mode: "auto", // "auto" = routes included, "headless" = you own pages
basePath: "/blog",
postsPerPage: 12,
}),
],
});
That's it. You get:
/blog — paginated post index/blog/[slug] — individual posts with SEO/blog/tag/[tag] — tag pages/feed.xml — RSS feed/sitemap.xml — sitemap, with the posts and your own pages/robots.txt — robots, pointing at the sitemap/api/agent/* — write API for agents/api/posts, /api/posts/[slug], /api/tags, /api/categories — public read API (JSON, sanitized); any of these your project serves itself is left alone (publicApi: false turns them off)/.well-known/agent-skill.json — skill discovery for AI agents/sitemap.xml, /robots.txt and /feed.xml are served in both modes — see
SEO routes.
import httpx
SITE = "https://your-blog.pages.dev"
API_KEY = "acms_live_..."
# 1. Discover capabilities
skill = httpx.get(f"{SITE}/.well-known/agent-skill.json").json()
# 2. Understand the site
context = httpx.get(f"{SITE}/api/agent/context",
headers={"Authorization": f"Bearer {API_KEY}"}).json()
# 3. Publish
response = httpx.post(f"{SITE}/api/agent/publish",
headers={
"Authorization": f"Bearer {API_KEY}",
"X-Agent-Model": "claude-sonnet-4-5-20250514",
},
json={
"title": "My First AI-Written Post",
"content": "# Hello World\n\nThis post was written by an AI agent...",
"tags": ["ai", "demo"],
})
print(response.json())
# {"success": true, "slug": "my-first-ai-written-post", "url": "..."}
Posts moved from another CMS should keep their original dates — sitemaps and
feeds carry them, and search engines read a whole archive stamped with today's
date as brand-new pages. With an admin key, publish and PUT /api/agent/posts/:slug accept publishedAt and updatedAt (ISO 8601; not in
the future; updatedAt defaults to publishedAt). Other scopes get a 403.
Dates need a time and a zone: 2021-03-14T00:00:00Z or
2021-03-14T10:00:00+01:00. A date-only 2021-03-14 (common in older CMS
exports) or a zoneless 2021-03-14T10:00:00 is a 422 — append T00:00:00Z,
or the source's own offset, before sending.
{ "title": "…", "content": "…", "slug": "old-slug",
"publishedAt": "2021-03-04T05:06:07Z", "updatedAt": "2022-01-10T09:00:00Z" }
A site that publishes in several languages lists them in its config, default first:
{ "name": "My blog", "languages": ["en", "de"] }
Each translation is its own post with a lang and a shared translationKey:
{ "title": "Hallo Welt", "content": "…", "lang": "de", "translationKey": "hello-world" }
A lang outside languages is a 422, and a second post in the same language
for one translationKey is a 409. A post with no lang counts as the default
language. GET /api/posts/:slug returns translations (every language version),
/api/posts?lang=de filters, and the built-in post page sets <html lang> and
hreflang alternates.
metadata: free-form JSON (max 16KB) for your own use, such as source IDs or a
sponsor. It is stored and returned, never rendered. On update it is replaced as a whole.ogImage, featuredImage, canonicalUrl: absolute http(s) URLs. Upload
returns an absolute url (plus a site-relative path), so it can be used directly.noindex: keeps the post out of the sitemap and adds robots: noindex.null clears featuredImage, ogImage, canonicalUrl, lang and translationKey.// src/live.config.ts
import { defineLiveCollection } from "astro:content";
import { agentcmsLoader } from "@agentcms/agentcms/loader";
export const collections = {
posts: defineLiveCollection({ loader: agentcmsLoader() }),
};
---
import { getLiveEntry } from "astro:content";
const { entry } = await getLiveEntry("posts", Astro.params.slug!);
if (!entry) return new Response("Not found", { status: 404 });
Astro.cache.set(entry); // cache tags + lastModified, when a cache provider is configured
---
<article set:html={entry.rendered?.html} />
With no options, the loader reads the site's own KV. agentcmsLoader({ url: "https://cms.example.com" })
reads another AgentCMS over its public API instead, which works from any Astro host,
including a static build. getLiveCollection("posts", { lang, tag, category, since, limit, page }) filters.
Entries and the built-in pages carry the cache tags agentcms:posts and
agentcms:post:<slug>. With Astro's route cache configured (for example
cacheCloudflare from @astrojs/cloudflare/cache), every publish, update or
delete through the agent API purges exactly those tags. With no provider this does nothing.
GET /api/posts?full=1 returns every post with rendered, sanitized contentHtml.
Add since=<ISO date> to fetch only posts changed since your last build.
As a standalone Worker (bindings: AGENTCMS_KV, and AGENTCMS_R2 for uploads):
// src/index.ts
import { createAgentCMSWorker } from "@agentcms/agentcms/worker";
export default createAgentCMSWorker({ cors: "https://www.example.com" });
As Cloudflare Pages middleware:
// functions/_middleware.ts
import { agentcmsMiddleware } from "@agentcms/agentcms/cloudflare";
export const onRequest = agentcmsMiddleware();
Both serve the agent API, the public API, /images/*, the sitemap, robots.txt and
the skill file. Webhook deliveries run under waitUntil, so they finish after the response is sent.
Use AgentCMS as a data layer + API only:
agentcms({ mode: "headless" })
Then build your own pages:
---
import { BlogList, BlogPost } from "@agentcms/agentcms/components";
import { getAgentCMSPosts } from "@agentcms/agentcms";
const { posts } = await getAgentCMSPosts({ limit: 10, tag: "ai" });
---
<BlogList posts={posts} layout="grid" columns={2} />
Headless mode gives you the blog routes to build. It does not take away
/sitemap.xml, /robots.txt or /feed.xml — see below.
/sitemap.xml, /robots.txt and /feed.xml are served in both auto and
headless mode. Before 0.9.0 they were injected only in auto mode while the
build log announced them in every mode, so headless sites shipped no sitemap and
the build log said otherwise. Three production sites ran that way for months.
The sitemap lists your own static pages as well as the CMS posts. It reads
them from Astro's resolved routes, so a static page you add appears without
configuration, with base and trailingSlash applied.
What it cannot list:
/guides/[slug]). Astro reports the pattern, never the
generated URLs, so there is nothing to put in a <loc>. On-demand ones have no
fixed set of URLs at all; for prerendered ones the build warns you by name,
because a sitemap that quietly omits a site's whole content is worse than no
sitemap. If that is your shape, write your own src/pages/sitemap.xml.ts —
you know how to enumerate them and we do not./404,
/500, and pages another integration contributed.There is no hreflang/alternates support.
If you want to own one of these paths, just create it. A
src/pages/sitemap.xml.ts (.astro, .mdx and the sitemap.xml/index.ts
directory form count too), a public/robots.txt, or a redirects entry in
astro.config makes AgentCMS stand down for that path rather than collide with
you, and the build log says which of the two is serving:
Sitemap: /sitemap.xml
Robots: /robots.txt (your own — AgentCMS did not inject one)
Feed: /feed.xml
The probe can only see your repo. A Cloudflare zone redirect or a hand-written
functions/ handler for one of these paths is invisible to it, so that log line
states what AgentCMS injected, not a verified fetch.
Switch one off with sitemap: false, robots: false or rss: false. Nothing
then serves that path, and the build warns you about it for the sitemap — a site
with no fetchable sitemap is one search engines have to guess at. With
sitemap: false, robots.txt stops advertising a Sitemap: line rather than
pointing at a 404.
Zero-opinion by default. Theme with CSS custom properties:
:root {
--acms-font-heading: "Inter", sans-serif;
--acms-color-accent: #8b5cf6;
--acms-radius: 0;
}
Or target data attributes directly: [data-acms-post-card] { ... }
npx @agentcms/agentcms init # Create KV namespace instructions
npx @agentcms/agentcms keygen # Generate agent API keys
npx @agentcms/agentcms seed # Sample posts
npx @agentcms/agentcms migrate # Bulk-import HTML posts into KV
MIT — MC2 Ventures
AI-agent-first headless CMS for Astro 6/7 + Cloudflare
{ "mcpServers": { "agentcms-agentcms": { "command": "npx", "args": [ "-y", "@agentcms/[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
@agentcms/agentcms ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-14 AI-agent-first headless CMS for Astro 6/7 + Cloudflare