Facebook MCP
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Facebook Pages MCP server for the Meta Graph API — publishing, insights, moderation, messaging
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiเริ่มต้น↓ 507/สัปดาห์ · ★ –
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: รันบนเครื่อง
- ช่องทาง (transport): stdio
- หมวด: การตลาดและโซเชียล
- ต้องใส่ค่าเหล่านี้: FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_SECRET, FB_CONFIRM_TOKEN, FB_HTTP_TOKEN
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
- รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
- ค่าที่คุณต้องใส่เอง:
FB_SYSTEM_TOKEN,FB_ACCESS_TOKEN,FB_PAGE_TOKEN,FB_APP_ID,FB_APP_SECRET,FB_PAGE_ID,FB_API_VERSION,FB_ADS_API_VERSION,FB_REQUEST_TIMEOUT_MS,FB_HOST_CONCURRENCY,FB_MAX_RESULT_CHARS,FB_WRITE_MODE,FB_CONFIRM_TOKEN,FB_MEDIA_DIR,FB_JOURNAL_PATH,FB_ACTIVITY_STATE_PATH,FB_EXPORT_DIR,FB_TOOL_PACKAGES,FB_PACKAGES_DENY,FB_PACKAGES_READONLY,FB_TRANSPORT,FB_HTTP_TOKEN,FB_HTTP_PORT,FB_AD_ACCOUNT_ID,FB_ADS_BUDGET_CEILING,FB_ADS_CAMPAIGN_SPEND_CAP_MAX,FB_LOG_LEVEL
ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
- npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "ใส่ค่าของคุณ",
"FB_ACCESS_TOKEN": "ใส่ค่าของคุณ",
"FB_PAGE_TOKEN": "ใส่ค่าของคุณ",
"FB_APP_ID": "ใส่ค่าของคุณ",
"FB_APP_SECRET": "ใส่ค่าของคุณ",
"FB_PAGE_ID": "ใส่ค่าของคุณ",
"FB_API_VERSION": "ใส่ค่าของคุณ",
"FB_ADS_API_VERSION": "ใส่ค่าของคุณ",
"FB_REQUEST_TIMEOUT_MS": "ใส่ค่าของคุณ",
"FB_HOST_CONCURRENCY": "ใส่ค่าของคุณ",
"FB_MAX_RESULT_CHARS": "ใส่ค่าของคุณ",
"FB_WRITE_MODE": "ใส่ค่าของคุณ",
"FB_CONFIRM_TOKEN": "ใส่ค่าของคุณ",
"FB_MEDIA_DIR": "ใส่ค่าของคุณ",
"FB_JOURNAL_PATH": "ใส่ค่าของคุณ",
"FB_ACTIVITY_STATE_PATH": "ใส่ค่าของคุณ",
"FB_EXPORT_DIR": "ใส่ค่าของคุณ",
"FB_TOOL_PACKAGES": "ใส่ค่าของคุณ",
"FB_PACKAGES_DENY": "ใส่ค่าของคุณ",
"FB_PACKAGES_READONLY": "ใส่ค่าของคุณ",
"FB_TRANSPORT": "ใส่ค่าของคุณ",
"FB_HTTP_TOKEN": "ใส่ค่าของคุณ",
"FB_HTTP_PORT": "ใส่ค่าของคุณ",
"FB_AD_ACCOUNT_ID": "ใส่ค่าของคุณ",
"FB_ADS_BUDGET_CEILING": "ใส่ค่าของคุณ",
"FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "ใส่ค่าของคุณ",
"FB_LOG_LEVEL": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add facebook --env FB_SYSTEM_TOKEN='ใส่ค่าของคุณ' --env FB_ACCESS_TOKEN='ใส่ค่าของคุณ' --env FB_PAGE_TOKEN='ใส่ค่าของคุณ' --env FB_APP_ID='ใส่ค่าของคุณ' --env FB_APP_SECRET='ใส่ค่าของคุณ' --env FB_PAGE_ID='ใส่ค่าของคุณ' --env FB_API_VERSION='ใส่ค่าของคุณ' --env FB_ADS_API_VERSION='ใส่ค่าของคุณ' --env FB_REQUEST_TIMEOUT_MS='ใส่ค่าของคุณ' --env FB_HOST_CONCURRENCY='ใส่ค่าของคุณ' --env FB_MAX_RESULT_CHARS='ใส่ค่าของคุณ' --env FB_WRITE_MODE='ใส่ค่าของคุณ' --env FB_CONFIRM_TOKEN='ใส่ค่าของคุณ' --env FB_MEDIA_DIR='ใส่ค่าของคุณ' --env FB_JOURNAL_PATH='ใส่ค่าของคุณ' --env FB_ACTIVITY_STATE_PATH='ใส่ค่าของคุณ' --env FB_EXPORT_DIR='ใส่ค่าของคุณ' --env FB_TOOL_PACKAGES='ใส่ค่าของคุณ' --env FB_PACKAGES_DENY='ใส่ค่าของคุณ' --env FB_PACKAGES_READONLY='ใส่ค่าของคุณ' --env FB_TRANSPORT='ใส่ค่าของคุณ' --env FB_HTTP_TOKEN='ใส่ค่าของคุณ' --env FB_HTTP_PORT='ใส่ค่าของคุณ' --env FB_AD_ACCOUNT_ID='ใส่ค่าของคุณ' --env FB_ADS_BUDGET_CEILING='ใส่ค่าของคุณ' --env FB_ADS_CAMPAIGN_SPEND_CAP_MAX='ใส่ค่าของคุณ' --env FB_LOG_LEVEL='ใส่ค่าของคุณ' -- npx -y @ivanbaev/facebook-mcpเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "ใส่ค่าของคุณ",
"FB_ACCESS_TOKEN": "ใส่ค่าของคุณ",
"FB_PAGE_TOKEN": "ใส่ค่าของคุณ",
"FB_APP_ID": "ใส่ค่าของคุณ",
"FB_APP_SECRET": "ใส่ค่าของคุณ",
"FB_PAGE_ID": "ใส่ค่าของคุณ",
"FB_API_VERSION": "ใส่ค่าของคุณ",
"FB_ADS_API_VERSION": "ใส่ค่าของคุณ",
"FB_REQUEST_TIMEOUT_MS": "ใส่ค่าของคุณ",
"FB_HOST_CONCURRENCY": "ใส่ค่าของคุณ",
"FB_MAX_RESULT_CHARS": "ใส่ค่าของคุณ",
"FB_WRITE_MODE": "ใส่ค่าของคุณ",
"FB_CONFIRM_TOKEN": "ใส่ค่าของคุณ",
"FB_MEDIA_DIR": "ใส่ค่าของคุณ",
"FB_JOURNAL_PATH": "ใส่ค่าของคุณ",
"FB_ACTIVITY_STATE_PATH": "ใส่ค่าของคุณ",
"FB_EXPORT_DIR": "ใส่ค่าของคุณ",
"FB_TOOL_PACKAGES": "ใส่ค่าของคุณ",
"FB_PACKAGES_DENY": "ใส่ค่าของคุณ",
"FB_PACKAGES_READONLY": "ใส่ค่าของคุณ",
"FB_TRANSPORT": "ใส่ค่าของคุณ",
"FB_HTTP_TOKEN": "ใส่ค่าของคุณ",
"FB_HTTP_PORT": "ใส่ค่าของคุณ",
"FB_AD_ACCOUNT_ID": "ใส่ค่าของคุณ",
"FB_ADS_BUDGET_CEILING": "ใส่ค่าของคุณ",
"FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "ใส่ค่าของคุณ",
"FB_LOG_LEVEL": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"facebook": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "ใส่ค่าของคุณ",
"FB_ACCESS_TOKEN": "ใส่ค่าของคุณ",
"FB_PAGE_TOKEN": "ใส่ค่าของคุณ",
"FB_APP_ID": "ใส่ค่าของคุณ",
"FB_APP_SECRET": "ใส่ค่าของคุณ",
"FB_PAGE_ID": "ใส่ค่าของคุณ",
"FB_API_VERSION": "ใส่ค่าของคุณ",
"FB_ADS_API_VERSION": "ใส่ค่าของคุณ",
"FB_REQUEST_TIMEOUT_MS": "ใส่ค่าของคุณ",
"FB_HOST_CONCURRENCY": "ใส่ค่าของคุณ",
"FB_MAX_RESULT_CHARS": "ใส่ค่าของคุณ",
"FB_WRITE_MODE": "ใส่ค่าของคุณ",
"FB_CONFIRM_TOKEN": "ใส่ค่าของคุณ",
"FB_MEDIA_DIR": "ใส่ค่าของคุณ",
"FB_JOURNAL_PATH": "ใส่ค่าของคุณ",
"FB_ACTIVITY_STATE_PATH": "ใส่ค่าของคุณ",
"FB_EXPORT_DIR": "ใส่ค่าของคุณ",
"FB_TOOL_PACKAGES": "ใส่ค่าของคุณ",
"FB_PACKAGES_DENY": "ใส่ค่าของคุณ",
"FB_PACKAGES_READONLY": "ใส่ค่าของคุณ",
"FB_TRANSPORT": "ใส่ค่าของคุณ",
"FB_HTTP_TOKEN": "ใส่ค่าของคุณ",
"FB_HTTP_PORT": "ใส่ค่าของคุณ",
"FB_AD_ACCOUNT_ID": "ใส่ค่าของคุณ",
"FB_ADS_BUDGET_CEILING": "ใส่ค่าของคุณ",
"FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "ใส่ค่าของคุณ",
"FB_LOG_LEVEL": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
- System-user access token (Business Manager). Takes precedence over FB_ACCESS_TOKEN and FB_PAGE_TOKEN when several are set.
- Primary user access token. At least one of FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN or FB_PAGE_TOKEN must be set.
- Long-lived Page access token used as a fallback credential when no user or system-user token is configured. It belongs to exactly one Page, so set FB_PAGE_ID to that Page ID alongside it (the doctor…
FB_APP_IDenvMeta app ID; combined with FB_APP_SECRET it forms the app access token used to authorize /debug_token inspection.- Meta app secret. When set, appsecret_proof is attached to every call so a stolen bare token cannot be used on its own.
FB_PAGE_IDenvDefault Facebook Page ID, used when a tool call omits an explicit profile argument. Required when FB_PAGE_TOKEN is the only credential: it names the Page that token belongs to.FB_API_VERSIONenvGraph API version to target. Defaults to the tested pinned version; other values are accepted verbatim as an escape hatch but are not tested.FB_ADS_API_VERSIONenvMarketing API version the ads tools target (ad accounts, campaigns, ad sets, ads, insights, async reports). The Marketing API retires versions on its own, shorter schedule, so it is pinned separately…FB_REQUEST_TIMEOUT_MSenvPer-request timeout in milliseconds; integer in [1, 600000].FB_HOST_CONCURRENCYenvMaximum number of in-flight requests per Graph host; integer in [1, 64].FB_MAX_RESULT_CHARSenvCharacter budget applied by the result shaper before a tool result is truncated; integer in [500, 10000000].FB_WRITE_MODEenvWrite gating mode: plan (validating dry-run preview, the default) or apply. It never covers the irreversible and spend tiers, which always need a per-call apply plus a plan_id.- Operator confirmation token for out-of-band approval of irreversible or spend actions. The server prompts through MCP elicitation where the client supports it; otherwise the caller passes this value…
FB_MEDIA_DIRenvDirectory permitted for local media uploads. Unset means URL-only uploads and no local file access at all.FB_JOURNAL_PATHenvPath to the append-only write journal. Defaults to the XDG/%APPDATA% state path; the file is created owner-only (0600) and rotates by size.FB_ACTIVITY_STATE_PATHenvPath to the small JSON file where facebook_get_activity_since keeps, per Page, the horizon of the last complete read. Defaults to the XDG/%APPDATA% state path next to the journal; the file holds Page…FB_EXPORT_DIRenvDirectory where the insights tools write a CSV or JSON file when called with `output`. Defaults to `exports/` under the XDG/%APPDATA% state path. Files are written atomically and owner-only (0600) an…FB_TOOL_PACKAGESenvComma-separated tool packages or profiles to expose (e.g. core,posts,reader, or the profiles core|all|reader|publisher|moderator|ads). Omit for the default profile, which excludes ads.FB_PACKAGES_DENYenvComma-separated packages OR profiles to exclude even when FB_TOOL_PACKAGES enables them; deny wins over allow. Profile names expand here exactly as they do in FB_TOOL_PACKAGES, and a profile beats a…FB_PACKAGES_READONLYenvComma-separated packages OR profiles whose write tools are not registered at all; the read tools of those packages stay available. Profile names expand as they do in FB_TOOL_PACKAGES, so FB_PACKAGES_…FB_TRANSPORTenvTransport protocol: stdio (default) or http. The http transport binds 127.0.0.1 only and fails closed without FB_HTTP_TOKEN.- Bearer token guarding the HTTP transport; required when FB_TRANSPORT=http (the server refuses to start without it). At least 16 characters — a shorter value is refused (under stdio it is dropped with…
FB_HTTP_PORTenvPort for the HTTP transport (loopback only); used when FB_TRANSPORT=http. Integer in [1, 65535].FB_AD_ACCOUNT_IDenvDefault ad account ID (act_… or the bare numeric id) for the opt-in ads package.FB_ADS_BUDGET_CEILINGenvHard ceiling for any ads budget write, in minor units of the ad account's own currency (e.g. cents for USD). Non-negative integer; a write above it is refused. No currency conversion: size it for the…FB_ADS_CAMPAIGN_SPEND_CAP_MAXenvLargest campaign spend_cap (the lifetime total a campaign may spend) that an ads write may set, in minor units of the ad account's own currency. Non-negative integer; a cap above it is refused, never…FB_LOG_LEVELenvStderr log verbosity: debug, info, warn or error. Logs never go to stdout — that is the stdio protocol channel.
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub IvanBBaev ซึ่งเป็นเจ้าของ repo
- … ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับตัวอื่นในหมวด การตลาดและโซเชียลi
- ดาวมากกว่า 0% ของอีก 3605 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 75% ของอีก 3605 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 3605 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
Facebook MCP ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_SECRET, FB_CONFIRM_TOKEN, FB_HTTP_TOKEN
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.8.0) เข้า registry 11 วันที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
facebook-mcp — an MCP server for Facebook Pages
📖 [Documentation site →](https://ivanbbaev.github.io/facebook-mcp/)
A local-first, MIT-licensed TypeScript Model Context Protocol (MCP) server for developers who run their own Facebook Page(s) from an MCP client such as Claude Code, Claude Desktop, VS Code or Cursor. It talks to the Meta Graph API through your own Meta developer app and your own token: publishing, reading and insights, comment moderation and Messenger replies. Writes return a preview first by default (plan-and-apply), and the server sends no telemetry.
Things you could ask your agent once it is set up (the tools exist; see Status for what has been verified):
- _"Draft a post with this photo and schedule it for Friday 9:00 — show me the preview first."_
- _"Triage the unanswered comments on last week's posts."_
- _"Give me this week's Page report."_
Not for you if you do not want to create a Meta developer app and handle an App ID, an App Secret and a token yourself — hosted social-media connectors with a one-click login are a better fit for that. It is also not for personal profiles, Groups, Instagram (there is a sibling server) or a hosted service for other people's Pages — see Not in scope.
Status
🚧 Pre-1.0, and not yet verified against a live Page. The latest release is
0.8.0 on npm. This README describes
main, which can be ahead of that release;
unreleased changes are listed in
changes/unreleased/.
- Implemented, not live-verified. All 69 tools in the tool table are implemented. Every test in this repository runs against fakes and recorded fixtures behind a network fence that throws on a real
fetch, so "the tests pass" means "the code does what the fixtures say", not "Meta accepted it". A live smoke harness exists (scripts/smoke/) but has not been run against a real Page for any release. - No client verified by hand. CI starts the packed server with
npxon Linux, macOS and Windows, but no person has walked an install end-to-end in any MCP client yet — see Client compatibility. - Experimental tools. Some tools are marked experimental (list under Not in scope): they may change in any minor release, even after 1.0.
- Breaking changes are planned. 0.9 changes tool contracts (see Roadmap). Read Known limitations before you rely on anything.
Contents: Status · Features · Requirements · Setup · Client compatibility · Configure credentials · Permissions · Tools · How this compares · Known limitations · Not in scope · Your responsibilities · Roadmap · Security notes · Documentation · Support · Trademark · License
Features
Implementation status only — see Status for what "implemented" does and does not mean. "Experimental" follows the experimental tier.
| Area | Capability | Status |
|---|---|---|
| Core & diagnostics | Identity, Page listing, rate-limit usage, doctor pre-flight check, setup-token | ✅ Implemented, not live-verified |
| Reading | Page and post reads, Reels, reactions, Stories, albums and photos, cursor pagination | ✅ Implemented, not live-verified |
| Publishing | Text / link / photo / video / Reels posts, Stories, scheduling, edit and delete | ✅ Implemented, not live-verified |
| Insights | Page, post and Reel insights, a one-call Page report, a posts comparison table, metric-rename and retirement guidance | ✅ Implemented, not live-verified |
| Moderation | Comment reads and triage, replies, comment edits, hide, like, delete, private reply, block/unblock, moderation settings | ✅ Implemented, not live-verified |
| Messaging | Conversation reads, "what is new since", replies within the 24-hour window, saved replies; message reactions, attachments and labels | ✅ Implemented, not live-verified (some experimental) |
| Ads (opt-in) | Campaign / ad-set / ad reads, previews, insights, status, budget and spend-cap control; archive/delete, image upload, targeting edits, copies, boost | ✅ Implemented, not live-verified (some experimental) |
| Page profile (opt-in) | Edit the Page's about, description, website, phone, hours, temporary status | ✅ Implemented, not live-verified, experimental |
| Live verification | Every tool exercised against a real Page and a real ad account | ❌ Not done — see Status |
| npm / MCPB release | npx @ivanbaev/facebook-mcp, attested .mcpb bundle, MCP Registry listing | ✅ Published — 0.8.0 |
Each tool wraps one capability rather than mirroring every Graph edge. Six packages (53 tools) are on by default; ads and page_admin are opt-in.
- Local-first, no telemetry. Only three Meta hosts are ever reached (
graph,graph-video,rupload); nothing phones home. - Least-privilege credentials. Works with a never-expiring System User token (Business Manager) or a long-lived Page token — no App Review required for an admin operating their own assets.
- Safe writes. Tiered plan-and-apply gating; irreversible and spend actions require out-of-band confirmation and are never unlocked by an env flag alone.
- Secret hygiene. Value-based redaction of secrets at a single choke-point across logs, errors, tool results, and the write journal.
- Layered architecture. Lint-enforced
core ← api ← mcp ← tools ← cli ← serverlayering, tools-as-data with a central package registry.
Requirements
- Node.js ≥ 22 (enforced by
enginesand a runtime guard in the launcher; the project targets the version in.nvmrc). - A Meta (Facebook) developer app — a Business-type app at Standard Access is enough; no App Review is needed to operate your own assets.
- A Facebook Page (and, for the opt-in
adspackage, an ad account) you administer.
Setup
The first run is five steps, in this order. Most of the time goes into Meta's app UI. docs/runbooks/onboarding.md is the long form with troubleshooting.
- Meta app — create a Business-type app at https://developers.facebook.com/apps and note its App ID and App Secret (Settings → Basic).
setup-tokenneeds both. - Short-lived token — in the Graph API Explorer pick your app, User Token, tick the scopes you need (at least
pages_show_listandpages_read_engagement), and Generate Access Token. It lives 1–2 hours, so do step 3 right away. - Exchange it and write the env file —
setup-tokenswaps it for a ~60-day token, resolves your Page and writes the env file:
FB_APP_ID='<app id>' FB_APP_SECRET='<app secret>' \
FB_SETUP_TOKEN=' ' \ npx -y @ivanbaev/facebook-mcp setup-token
Success is status: completed in the Run block and status: written in the Env file block. The file lands at ~/.config/facebook-mcp/.env ($XDG_CONFIG_HOME if set) or %APPDATA%\facebook-mcp\.env on Windows, mode 0600. The server reads it on every start, so the client config below needs no env block. More than one Page? Re-run with --page= --force.
- Pre-flight — every package you plan to use should be
usable:
npx -y @ivanbaev/facebook-mcp doctor
- Register the server with your client and make the first call — see the next two subsections, then
ตัดมาแค่ช่วงต้น อ่านต่อใน repo