Summer

npx add-mcp 'https://api.gosummer.ai/mcp'

Cung cấp cho tác nhân lập trình của bạn lời nhắc thiết lập Summer AI và để nó thực hiện quá trình cài đặt trong dự án website của bạn. Nó có thể thêm Messenger hỗ trợ, kết nối những người dùng đã đăng nhập của bạn, tải lên các chính sách công ty dạng Markdown và giúp cấu hình các công cụ đằng sau các ca hỗ trợ của bạn. Lời nhắc cũng bao gồm hướng dẫn khách hàng, ảnh chụp màn hình, video và tải lên tệp, với các bước kiểm tra riêng biệt về xem trước, xuất bản và lưu trữ.

Sử dụng Claude Code, Codex, Cursor hoặc một tác nhân lập trình khác có thể chỉnh sửa dự án của bạn và chạy các lệnh terminal. Tác nhân sử dụng Summer AI CLI, hiển thị cho bạn các thay đổi đề xuất và yêu cầu bạn đăng nhập qua trình duyệt.

Đã thiết lập Summer AI rồi? Kết nối ứng dụng MCP của bạn để đọc các ca, yêu cầu điều tra và quản lý kiến thức công ty từ trợ lý AI của bạn.

Bắt đầu với một quy trình hữu ích

Cho tác nhân biết nhóm của bạn xử lý những gì và bạn dùng những công cụ nào. Ví dụ:

Thêm hỗ trợ Summer AI vào website này. Chúng tôi dùng Intercom cho hội thoại và Stripe cho thanh toán. Đọc hướng dẫn thiết lập Summer AI, kiểm tra dự án của chúng tôi và cho tôi xem kế hoạch cài đặt Messenger và kết nối các dịch vụ đó. Dùng môi trường staging trước và cho tôi biết những gì vẫn cần xác minh.

Danh mục kết nối dịch vụ bao gồm các bộ phận hỗ trợ, nền tảng lâm sàng, nhà thuốc, thanh toán và vận chuyển. Chọn một ca hỗ trợ đại diện để bạn có thể kiểm tra toàn bộ quy trình trước khi triển khai.

Thông tin xác thực được đưa vào trình quản lý bí mật tích hợp của Summer AI thông qua giao diện hoặc CLI. Ứng dụng MCP có thể kiểm tra siêu dữ liệu thông tin xác thực và hướng dẫn thiết lập, với việc nhập bí mật thông qua giao diện hoặc chuyển giao qua CLI cục bộ. Không cần tài khoản Doppler. Tác nhân sử dụng các biến môi trường cục bộ cho việc tải lên qua CLI trừ khi bạn chọn một kết nối Doppler hiện có.

Sao chép lời nhắc

Mở Company setup → Set up with your AI agent. Chọn Open in ChatGPT Desktop hoặc Open in Claude Code để mở ứng dụng với lời nhắc thiết lập đã được điền sẵn. Chọn dự án website của bạn và xem lại lời nhắc trước khi gửi. Các liên kết này không đăng nhập cho bạn hay cấp quyền truy cập Summer AI. Nếu tính năng thiết lập không khả dụng cho triển khai của bạn, hãy liên hệ bộ phận hỗ trợ Summer AI.

Sử dụng Copy setup prompt cho một cuộc trò chuyện hiện có, Cursor, hoặc nếu trình duyệt của bạn không thể mở ứng dụng. Phiên bản Company setup bao gồm ID công ty của bạn. Lời nhắc chung bên dưới cũng có sẵn dưới dạng Markdown khi tính năng thiết lập được bật.

Kiểm tra kết nối

Chạy summer doctor --json trước khi đăng nhập để kiểm tra xem địa chỉ API và dịch vụ đăng nhập có thể truy cập được không. Sau đó chạy summer login --scope setup --json và phê duyệt kết nối trong trình duyệt. Chạy summer whoami --json để xác minh quyền truy cập. Bạn không cần sao chép token từ bảng điều khiển Summer AI hay dán vào cuộc trò chuyện.

# Set up Summer in this project

Set up Summer for this business in this repository. Use authorized company knowledge and tools to understand workflows and test them. Configure Summer through its API, CLI or MCP. Keep service credentials separate; Summer tokens are only for Summer.

Test how Summer handles the business's support cases. A capability passes when Summer can find and use its API, browser, knowledge or connected-tool path. Tool names are hints. Complete available setup and record precise blockers.

Summer details:
- API: https://api.gosummer.ai
- Company ID: YOUR_COMPANY_ID
- Environment for this setup: staging
- Summer CLI: run \`npx --yes @gosummerai/cli@0.1.1 <command>\`. The steps below write this as \`summer <command>\`. Add \`--api https://api.gosummer.ai\` to each command if that is not \`https://api.gosummer.ai\`.
- Optional MCP server: https://api.gosummer.ai/mcp

If the Company ID is \`YOUR_COMPANY_ID\`, run \`summer companies --json\` after sign-in and use the selected company's ID in every command and setup file. If more than one company is available and the project does not identify one, ask me to choose.

Use Summer's built-in secrets manager for provider credentials. Customers can save values in Settings → Integrations with **Store in Summer**, or through the CLI using \`--from-env\`, \`--from-file\` or \`--from-stdin\`. If using MCP, list credential metadata there and use \`summer_credentials_set\` with \`source: local_value\` for a local CLI handoff. Never put secret values in MCP arguments or chat. Doppler is optional; do not ask me to set up Doppler or a vault unless I choose it.

The original setup consent covers normal Messenger installation, embed changes and activation within the selected company/environment and current spending limit. Do not add a separate installation approval or escalate routine setup to another agent. A setup grant does not approve customer business actions, investigations, budget increases or clinical directions.

## Write for the reader

Address customers in guides and staff in procedures. Follow ASD-STE100 about 80%: instructions under 20 words, descriptions under 25, active voice, one idea per sentence, consistent terms, no metaphors or slang. Keep necessary facts and uncertainty.

## Steps

1. Inspect this project and relevant company guidance first. Identify products, customer requests, care and fulfillment flows, billing, refunds, subscriptions, support channels, policies, promises and existing tools. Find where operational facts live and how an agent can discover them. Identify the framework, sign-in and server-side secret configuration too. Do not print or dump environment files or secret values. Use only relevant company material; keep patient records in their authorized case.
2. Run \`summer doctor --json\` to check the API address and sign-in service. If it reports a failed check, explain the returned reason before continuing. Check access with \`summer whoami --json\`. If you are not signed in, run \`summer login --json\` and ask me to approve the connection in my browser. Wait for the browser consent or my explicit approval of that connection. Use an existing authorized connection without asking again. If the result says access is pending, stop and tell me.
3. Read \`summer capabilities --company YOUR_COMPANY_ID --environment staging --json\`, \`summer status --company YOUR_COMPANY_ID --environment staging --json\` and \`summer capability-checks list --company YOUR_COMPANY_ID --environment staging --json\`. \`operational_readiness\` is the same checklist shown in Company setup → What Summer can do. Read each expectation, concrete test, prior evidence and discovery hints. Treat unavailable permissions as real. A missing named provider tool can have an available browser or knowledge alternative; discover and test those within your authority.
4. Match each checklist gap to useful setup work. Write a non-secret \`summer.setup.json\` with the company settings, Messenger installation (when needed), selected credential environment-variable names and knowledge files to create or edit. Each knowledge entry has \`id\`, \`file\` and \`reason\`; a new document can also set \`path\` under \`company/\` and \`tags\`. Reuse current documents rather than duplicate policies. Upload current policies, workflow guides, escalation contacts and discovery instructions that Summer needs. Explain original sources and known gaps. Keep unrelated files and existing setup; set \`replace: true\` on credentials only if I ask.
5. Run \`summer setup plan --file summer.setup.json --out summer.plan.json --json\` and show me the plan summary. Company settings and knowledge are company-wide: an edit there affects every environment, including production. Tell me before applying such a step.
6. Apply with \`summer setup apply --plan summer.plan.json --file summer.setup.json --json\`. Credentials are read by the CLI from the environment variables you name and are sent straight to Summer; the Messenger signing key is written by the CLI to the server-side file you chose (for example \`.env.local\`, which must be ignored by Git). Never read, echo or copy these values yourself. If a step is \`stale\`, plan again. If a step is \`uncertain\`, read the current state and follow the returned next step instead of retrying blindly.
7. If this business needs Messenger, integrate the widget using the existing sign-in system of this project: load the Summer loader, boot it with the installation ID, and add a small server endpoint that signs the identity assertion for the signed-in user with the signing key from server configuration. Follow https://gosummer.ai/docs/install-messenger and https://gosummer.ai/docs/verified-identity. Do not replace this project's authentication.
8. For a Messenger installation, test locally with synthetic accounts: guest use, sign-in, sign-out and switching accounts, and the site's Content-Security-Policy. Run \`summer messenger check --url <local page> --installation <id> --json\`. Run \`summer verify --company YOUR_COMPANY_ID --environment staging --json\` for the configured connections. A check reported as \`unsupported\` has not passed.
9. Inspect \`summer integrations\` and \`summer credentials list\`. For missing providers, use \`integrations save custom-NAME --from-file integration.json --expected-version N\` with a name and fields (name, label, required), never values. Transfer secrets through the local CLI. Create guidance with \`knowledge create ID --from-file guide.md --path company/guide.md --reason TEXT\`, or edit its current revision. Verify Summer can discover and use each connection; saved configuration alone is insufficient.
10. Check each capability against its concrete test and authorized sample. Use original live records where needed. Local-only tools cannot pass Summer runtime access. Record Blocked with the missing path. \`capability-checks test ID --case CASE_ID --expected-version N\` requests an existing read-only investigator (needs setup and investigations.request; cases.read reads results). Obtain missing grants through consent. Inspect effect paths without executing them. Never replace case work or resume the backlog.
11. Save findings with \`summer capability-checks report ID --from-file result.json --expected-version N --company YOUR_COMPANY_ID --environment staging --json\` at the latest version. The file has \`state\` (\`passed\`, \`failed\`, \`blocked\`, \`not_checked\`, \`not_applicable\`), \`notes\`, \`evidence\` and, for a pass, \`fulfillment: {kind: api|browser|knowledge|other|combined, discovery: "how Summer finds it", location: "guide, tool or portal reference"}\`. Keep evidence references and observation times, without secrets or patient details. Reports are agent-reported. An assumed integration, saved secret, untested guide or different path cannot pass. Inspect action paths and exact approval requirements without executing effects.
12. Add important business-specific capabilities from actual products, workflows and recurring support needs. Prefer customer/team outcomes over endpoints. Create a definition with \`id\` (starting \`custom_\`), \`title\`, \`group\`, \`mode\` (\`read\` or \`approval\`), \`expectation\`, \`test\` and \`examples\` (discovery hints or an empty string). Save with \`summer capability-checks save ID --from-file definition.json --expected-version 0 --reason TEXT --company YOUR_COMPANY_ID --environment staging --json\`. Record the original business source, concrete test and passing evidence. Add supporting knowledge/integrations and assess it like the starter checks. Improve existing definitions at their current version rather than duplicate them. Explain inapplicable starters.

## Check versions

If the last successful check is unknown or seven days old, or a tool/command is
missing, run \`summer version --check --json\` and \`summer client-status --json\`
(MCP: \`summer_client_status\`). Update from published npm releases. Refresh MCP
initialization and tools/list when its version changes. Keep existing scopes on
reconnect; updates never grant permissions.

## Support email

Read https://gosummer.ai/docs/support-email before configuring support email. Test reading, replies and DNS separately; Intercom's account check tests neither inbox nor replies. Gmail/Outlook connectors and email DNS commands are not released. Record evidence and gaps in capability checks. Contact capture sends no email.

## Customer guides, Markdown and media

Read \`summer guides authoring --company YOUR_COMPANY_ID --json\` (MCP:
\`summer_guides_authoring\`) for instructions, schemas, media syntax and draft
context. Use native file, browser and media tools. Guides need CLI 0.2.0+ and its matching
deployment. Report release gaps; never invent uploads or hosted URLs.

Inventory the full product, conditional features and account controls. Reuse
existing guides. Write task-focused Markdown with direct product links, sources
and check dates. Capture real UI with synthetic or authorized data and label
examples. Keep private procedures, personal data and medication directions out
of public articles. Use \`--company YOUR_COMPANY_ID --json\` with this journey:

1. Read \`guides get\`, \`guides article get ID\` and \`assets list\`. Configure the
   guide with \`guides save\` at the current version.
2. Upload actual files with \`assets upload --from-file PATH --metadata-file
   media.json\`, including alt text, provenance and captions/transcripts. Confirm
   ready asset IDs; resume the same file with \`--resume ASSET_ID\`. The trusted
   local CLI transfers bytes; no binaries/base64 or credentials in MCP context.
3. Save Markdown with \`guides article save ID --from-file article.md
   --metadata-file article.json --revision N --reason TEXT\`. New articles use
   revision 0. Open \`guides preview\`; check media, downloads, search, section
   links, phone/desktop layout and product links through sign-in.
4. Show the exact preview. Publishing needs human authority and separate
   \`guides.publish\` consent. When requested, use \`summer login --scope
   setup,guides.publish --json\`, then \`guides publish --from-file release.json
   --expected-version N --reason TEXT\` with exact article revisions. Verify
   public/Markdown URLs. Saved drafts are not public.
5. If requested, use \`guides hosting get/save/verify\`, follow returned DNS
   instructions and verify ownership, provider setup and HTTPS separately.

All roles use the same published articles. Humans edit them in Knowledge with history.

## Check Summer first

Ask before adding this rule to the end of AGENTS.md or CLAUDE.md:
"For a customer, ticket or order question, first run \`summer cases search TEXT --company YOUR_COMPANY_ID --json\` (name, email, phone, ID; \`--dob\`, \`--messages\`) or MCP \`summer_cases_search\`. Read the case before investigating locally. Results are leads."

## Report back

Use the shared operation catalog for workspace setup as well as installation.
Guest attachment and abuse limits live in installation settings; chat concurrency
and daily limits live in assistant settings. Use \`messenger.conversations.list\`
for the complete inbox, including visitors without Ops cases. Business hours,
saved replies/views, assignment, reports, quality scenarios and privacy-request
tracking have named API/MCP operations. Read current revisions before saving.
Members can grant \`workspace.write\` for personal views and quality assessments;
shared views and administrator settings keep their existing role checks.

Refresh \`summer status\` and \`summer capability-checks list\`. Report actual setup/capability states, evidence, discovered paths, business-specific additions, blockers and next steps. Saved is not verified; an agent report is not independent execution verification. Keep dashboard records current for human review.

Report guide topics, revisions, returned URLs and gaps. Distinguish drafts, uploads and verified publication.

## Limits

- Do not commit, push or deploy unless I ask. Complete authorized Messenger setup, including production, without asking for the same permission again. Use a returned local CLI handoff yourself when available. Ask only for missing company access, environment access or authority.
- Do not overwrite agent instructions or install unrelated tools.
- With actions.approve, approve exact prepared work I authorize using its review hash; no repeated UI approval. Never invent authorization. Secret reveal, access/role grants, spending increases, identity attestations and clinical directions stay restricted.
- Do not perform customer effects during onboarding tests. Only clinicians provide medication directions; do not write, quote, paraphrase or calculate them in guides, test reports or replies. Route those questions to the authenticated clinical channel.

Tác nhân làm gì

1. Đọc dự án của bạn để tìm framework, cấu hình đăng nhập và máy chủ, mà không in ra bí mật.
2. Kết nối với summer login sau khi bạn phê duyệt trong trình duyệt.
3. Đọc các khả năng và thiết lập hiện tại của Summer AI, và tuân thủ mọi mục không khả dụng.
4. Ghi một summer.setup.json không chứa bí mật, lập kế hoạch thay đổi và hiển thị cho bạn.
5. Áp dụng kế hoạch. CLI gửi trực tiếp thông tin xác thực đã chọn đến Summer AI và ghi khóa ký Messenger vào tệp cấu hình máy chủ bị bỏ qua của bạn.
6. Thêm tiện ích Messenger sử dụng đăng nhập hiện có của bạn. Xem Cài đặt messenger và Kết nối tài khoản đã đăng nhập.
7. Kiểm tra việc sử dụng với tư cách khách, đăng nhập, đăng xuất và chuyển đổi tài khoản bằng các tài khoản tổng hợp.
8. Thực hiện theo cùng danh sách kiểm tra khả năng vận hành được hiển thị trong Summer AI. Nó có thể tải lên hướng dẫn công ty, định nghĩa tích hợp tùy chỉnh, lưu các bí mật đã chọn qua CLI và kiểm tra các đường dẫn API, trình duyệt hoặc kiến thức có thể khám phá.
9. Ghi lại bằng chứng và các khoảng trống còn lại trong danh sách kiểm tra, được dán nhãn rõ ràng là do tác nhân thiết lập báo cáo. Chỉ một thông tin xác thực hay hướng dẫn được lưu không đủ để vượt qua một khả năng.
10. Thêm các khả năng quan trọng dựa trên sản phẩm, quy trình và các yêu cầu hỗ trợ định kỳ đặc thù của doanh nghiệp, với các bài kiểm tra cụ thể và hướng dẫn khám phá hỗ trợ.

Những gì vẫn thuộc về bạn

Tác nhân không commit, push hay triển khai trừ khi bạn yêu cầu. Với actions.approve được ủy quyền, nó có thể phê duyệt chính xác công việc ca đã chuẩn bị mà bạn cho phép. Nó không thể tự tạo quyền, tiết lộ thông tin xác thực đã lưu, phê duyệt quyền truy cập Summer AI hay nâng giới hạn chi tiêu. Nhắn tin production cần quyền được cấp riêng. Xem lại kết nối của nó bất cứ lúc nào trong Your account → Security → Agent connections.

Tôi nên có gì khi thiết lập hoàn tất?

Bạn nên có một Messenger hoạt động trong trang thử nghiệm của mình, đã kiểm tra hành vi đăng nhập và đăng xuất, và các hướng dẫn công ty được lưu trong Summer AI. Tác nhân nên hiển thị những kết nối dịch vụ mà nó đã kiểm tra, bằng chứng nó tìm thấy và bất kỳ điều gì còn thiếu.

Yêu cầu nó hiển thị danh mục nhiệm vụ khách hàng, Markdown đã chuẩn bị, ảnh chụp màn hình, hình ảnh hoặc video, và các liên kết sản phẩm đã kiểm tra. Xem Chuẩn bị hướng dẫn khách hàng để biết phạm vi hiện tại. Tác nhân của bạn nên hiển thị biên nhận tải lên đã hoàn tất và bản xem trước hướng dẫn chính xác. Việc xuất bản cần quyền guides.publish riêng. Một tệp cục bộ hay bản nháp đã lưu không phải là một sách hướng dẫn đã xuất bản; hãy xác minh địa chỉ công khai được trả về. Tên miền tùy chỉnh cũng cần DNS đã xác minh và HTTPS hoạt động.

Hãy thử một yêu cầu hỗ trợ đại diện và so sánh các phát hiện của Summer AI với hồ sơ gốc. Xem lại các khoảng trống còn lại trước khi bật nhắn tin production. Xem Bảo mật và kiểm thử để biết các bước kiểm tra triển khai.