docs: add Claude project context files

2026-05-31 12:44:04 +00:00
parent 9ada57e5e7
commit 0411771a7d
1 changed files with 42 additions and 0 deletions
@@ -0,0 +1,42 @@
+# AskTam Advanced MCP Plugin — Project Context
+
+## What This Is
+
+A custom WordPress plugin that exposes a full Model Context Protocol (MCP) server inside WordPress. It allows Claude (via the claude.ai MCP connector or any MCP client) to directly read and write WordPress content through a secure, scoped API — no WP Admin, no WP-CLI required.
+
+## Owner
+
+- **Agency:** AskTam (asktam.net)
+- **Developer:** Tam (colorlink / loveriver7@gmail.com)
+- **Location:** Jeddah, Saudi Arabia
+
+## Repository
+
+- **Gitea:** git.asktam.net/colorlink/advanced-mcp-plugin
+- **Branch:** main
+- **Current version:** 2.1.0
+
+## Live Environment
+
+- **WordPress URL:** https://mainwp.asktam.net
+- **Container:** `mainwp` (Docker)
+- **VPS:** 76.13.157.7 (srv1631399.hstgr.cloud)
+- **Plugin path inside container:** `/var/www/html/wp-content/plugins/advanced-mcp-plugin/`
+- **DB prefix:** `mwp_`
+- **PHP:** 8.x inside container
+- **Theme:** WoodMart (WooCommerce + Elementor)
+- **WP-CLI:** `/usr/local/bin/wp` — always requires `--allow-root`
+
+## MCP Endpoint
+
+```
+POST https://mainwp.asktam.net/wp-json/asktam-mcp/v1/mcp
+Authorization: Bearer <jwt_token>
+Content-Type: application/json
+```
+
+## Security Status
+
+Audit grade: **A+ (30/30 checks passed)** — 2026-05-31
+
+See `docs/04-SECURITY.md` for full details.