Booking MCP

WFCS预订--克劳德代理入职

为The Well Foundation的Claude经纪人提供一个角色意识的入职网站。用户使用其现有的WFCS Booking帐户登录，被重定向到其特定角色的页面，并看到他们可以直接复制到Claude的精心策划的提示。

居住地址： booking-mcp-docs.wellfoundation.org.uk

______________________________________________________________________

它做什么

• 用户使用其WFCS预订凭据登录（与主应用程序相同的电子邮件/密码）
• 该网站检测他们的角色（客户、讲师、管理员、超级管理员）并相应地重定向
• 每个角色都会看到一个快速入门页面，其中包含5-7个最有用的提示
• 一个完整的提示库页面每个角色有30-70多个提示，可按类别搜索和过滤
• 没有自己的后端-身份验证由WFCS Booking API处理

______________________________________________________________________

本地开发

要求Galvani从git根运行：

# From /Users/waseem/Sites/www/
./galvani

# Site available at:
http://localhost:8080/booking/mcp/booking-mcp-docs/index.html?nocache=1

# Note: always use ?nocache=1 when testing after JS changes
# to bypass browser caching of index.html

测试证书（全部使用 password123):

______________________________________________________________________

结构

booking-mcp-docs/
├── index.html              # Login page
├── customer/
│   ├── index.html          # Quick Start (5 prompts)
│   └── prompts.html        # Full library (search + filter)
├── instructor/
│   ├── index.html
│   └── prompts.html
├── admin/
│   ├── index.html
│   └── prompts.html
├── super-admin/
│   ├── index.html
│   └── prompts.html
├── assets/
│   ├── styles.css          # All styles — no inline CSS anywhere
│   ├── app.js              # Auth, theme toggle, CSRF, prompt rendering
│   └── prompts-data.js     # All prompts keyed by role and category
├── docs/
│   ├── TESTING.md          # Manual testing checklist
│   └── LAUNCHING.md        # Launch and deployment checklist
├── .github/workflows/
│   └── deploy.yml          # GitHub Pages deploy on push to master
└── CNAME                   # booking-mcp-docs.wellfoundation.org.uk

______________________________________________________________________

更新提示

所有提示均已上线 assets/prompts-data.js结构如下：

var promptsDatabase = {
    customer: {
        activities: [ { text: '...', difficulty: 'easy' }, ... ],
        bookings:   [ ... ],
        // ...
    },
    instructor: { ... },
    admin: { ... },
    'super-admin': { ... }
};

要添加或编辑提示，请执行以下操作：

1. 编辑 assets/prompts-data.js
2. 承诺并推动 master
3. GitHub Pages会自动部署，无需重新构建

难度值： easy | intermediate | advanced

______________________________________________________________________

部署

通过Cloudflare在GitHub Pages上托管自定义域。

• 推至 master → GitHub Actions会自动部署（请参阅 .github/workflows/deploy.yml)
• 自定义域： booking-mcp-docs.wellfoundation.org.uk （Cloudflare CNAME→ waseemsadiq.github.io)
• 通过GitHub Pages设置强制执行HTTPS

所需的存储库机密：

实时预订API URL未在回购中进行硬编码。在部署之前，请将其添加到：

GitHub 仓库→ 设置→ 秘密和变量→ 行动→ 新存储库机密

部署工作流将此替换为 app.js 在构建时。git repo只包含占位符 __BOOKING_API_URL__.

看 docs/launchhing.md 查看完整的发射清单。

______________________________________________________________________

身份验证的工作原理

1. 登录页面获取 csrf_token 来自预订应用程序的cookie（来源相同）
2. 它将凭据发布到 /api/auth/login CSRF令牌在 X-CSRF-Token 头球
3. 成功后，JWT存储在 localStorage
4. GET /api/auth/verify-token 返回用户的角色，该角色驱动重定向
5. 所有角色页面调用 requireAuth() 加载时--无效/丢失的令牌重定向到登录

CSRF备注：令牌以两者的形式发送 X-CSRF-Token 标题和 _csrf_token 在JSON正文中。服务器首先检查标头。