DocSpring

npx add-mcp 'https://mcp.docspring.com/mcp'

Mở trong Claude Mở trong ChatGPT

Máy chủ MCP của DocSpring cho phép trợ lý AI làm việc trong tài khoản DocSpring của bạn. Máy chủ có thể tìm mẫu, điền thông tin và tạo PDF cùng tài liệu Word, tạo thiết kế trang, chỉnh sửa trường và xuất bản phiên bản, thiết lập yêu cầu chữ ký cũng như quản lý thư mục, webhook và tác vụ email. Đây là máy chủ từ xa sử dụng Model Context Protocol: bạn thêm URL của máy chủ vào trợ lý rồi đăng nhập vào DocSpring. Bạn không cần sao chép mã thông báo API.

Khu vực	URL máy chủ MCP
US	https://mcp.docspring.com/mcp
EU	https://mcp-eu.docspring.com/mcp

Hãy dùng URL của khu vực nơi đặt tài khoản của bạn. Nếu bạn đăng nhập vào DocSpring tại app-eu.docspring.com, tài khoản của bạn ở EU. Các ví dụ bên dưới dùng URL US. Với EU, hãy dùng URL của khu vực đó trong các lệnh và tệp cấu hình, đồng thời đặt tên máy chủ là docspring-eu, như plugin DocSpring thực hiện, để máy chủ này không thay thế máy chủ US có tên docspring.

Đối với các tác nhân lập trình (Claude Code, Codex, Copilot, Gemini CLI), plugin DocSpring thêm máy chủ MCP cùng với các kỹ năng tác nhân của DocSpring, giúp tác nhân nắm được quy trình làm việc với DocSpring.

Kết nối trợ lý

Thêm URL vào trợ lý, sau đó đăng nhập vào DocSpring trong trình duyệt và chọn những việc trợ lý có thể thực hiện (xem Quyền truy cập).

Chưa có tài khoản DocSpring? Hãy tạo tài khoản trên trang đăng nhập mà trợ lý mở ra bằng Google, GitHub hoặc email của bạn, rồi kết nối từ đó. Sau đó, yêu cầu trợ lý thiết kế mẫu đầu tiên cho bạn.

Claude

Claude.ai, Claude Desktop và các ứng dụng di động của Claude dùng chung các trình kết nối. Các nút này mở hộp thoại “Add custom connector” của Claude với URL của DocSpring đã được điền sẵn:

Để tự thêm, hãy vào Customize > Connectors, nhấp + Add, rồi chọn Add custom connector. Nhập DocSpring làm tên và URL máy chủ MCP, sau đó nhấp Add và đăng nhập. Trong cuộc trò chuyện, bật DocSpring từ menu + bên dưới Connectors.

Trình kết nối tùy chỉnh hoạt động trên mọi gói Claude (gói Free cho phép một trình kết nối). Với gói Team và Enterprise, chủ sở hữu thêm trình kết nối trong Organization settings > Connectors, sau đó từng thành viên kết nối trình kết nối đó từ Customize > Connectors.

Claude Code

claude mcp add --transport http --scope user docspring https://mcp.docspring.com/mcp

Sau đó chạy /mcp trong Claude Code, chọn docspring và đăng nhập. --scope user thêm máy chủ cho tất cả dự án của bạn. Nếu bạn đăng nhập Claude Code bằng gói đăng ký Claude, trình kết nối DocSpring mà bạn đã thêm trong Claude sẽ có sẵn.

ChatGPT

Để thêm máy chủ MCP vào ChatGPT, bạn cần không gian làm việc Business, Enterprise hoặc Edu; tính năng này chỉ hoạt động trên web. Trong không gian làm việc Business, quản trị viên hoặc chủ sở hữu sẽ thêm máy chủ. ChatGPT Pro có thể thêm máy chủ với các công cụ chỉ đọc.

1. Mở Plugins, nhấp +, rồi chọn Add custom MCP server.
2. Nhập DocSpring làm tên, URL máy chủ MCP làm kết nối và chọn OAuth để xác thực.
3. Xác nhận, nhấp Create as a plugin rồi đăng nhập vào DocSpring.

Trong cuộc trò chuyện, nhập @ rồi chọn DocSpring.

Codex

codex mcp add docspring --url https://mcp.docspring.com/mcp
codex mcp login docspring

Codex CLI, tiện ích IDE và ứng dụng ChatGPT trên máy tính dùng chung cấu hình này.

Cursor

Hoặc thêm máy chủ vào ~/.cursor/mcp.json (mọi dự án) hoặc .cursor/mcp.json (một dự án):

{
  "mcpServers": {
    "docspring": { "url": "https://mcp.docspring.com/mcp" }
  }
}

Cursor sẽ yêu cầu bạn đăng nhập sau khi thêm máy chủ.

VS Code

Hoặc chạy MCP: Add Server từ Command Palette và chọn HTTP, hoặc thêm máy chủ vào .vscode/mcp.json:

{
  "servers": {
    "docspring": { "type": "http", "url": "https://mcp.docspring.com/mcp" }
  }
}

VS Code sẽ mở trình duyệt để bạn đăng nhập trong lần kết nối đầu tiên.

Các trợ lý khác

Mọi ứng dụng khách MCP hỗ trợ máy chủ từ xa (Streamable HTTP) với đăng nhập OAuth đều có thể kết nối: Gemini CLI, Zed, Goose và các ứng dụng khác. Thêm URL máy chủ MCP làm máy chủ từ xa hoặc máy chủ HTTP; ứng dụng khách sẽ mở trang đăng nhập DocSpring khi kết nối lần đầu. Ví dụ, trong Gemini CLI:

gemini mcp add --scope user --transport http docspring https://mcp.docspring.com/mcp

Quyền truy cập

Khi đăng nhập, DocSpring yêu cầu bạn chọn những việc trợ lý có thể thực hiện. Read and write được chọn sẵn cho đến khi bạn chọn tùy chọn khác:

Quyền truy cập	Trợ lý có thể làm gì
Read only	Xem mẫu, thư mục, hồ sơ gửi và PDF của chúng, tác vụ email và miền email của bạn, đồng thời kiểm tra dữ liệu theo mẫu
Read and write	Ngoài ra còn có thể tạo và chỉnh sửa mẫu cùng các trường, xuất bản phiên bản, tạo PDF, tạo yêu cầu chữ ký, thêm và kiểm tra miền email
Full access	Ngoài ra còn có thể xóa mẫu, phiên bản, thư mục và miền email, hết hạn hồ sơ gửi, tạo webhook gửi hồ sơ gửi và các sự kiện khác của bạn đến một URL, cũng như tạo tác vụ email gửi PDF của bạn qua email

Nếu trợ lý yêu cầu ít hơn quyền truy cập đầy đủ khi đăng nhập, DocSpring sẽ liệt kê những quyền mà trợ lý yêu cầu; bạn có thể kết nối với các quyền đó hoặc hủy.

Trợ lý chỉ thấy những công cụ được phép theo quyền truy cập của nó. Công cụ máy chủ MCP liệt kê các công cụ này.

Mỗi trợ lý đã kết nối được liệt kê trong Connected apps trên trang Integrations của DocSpring. Bất kỳ ai trong tài khoản cũng có thể ngắt kết nối trợ lý tại đó; quyền truy cập của trợ lý sẽ bị dừng ngay lập tức. Để thay đổi quyền truy cập của trợ lý, hãy ngắt kết nối rồi đăng nhập lại.

PDF thực tế sử dụng tín dụng trong tài khoản của bạn, giống như khi dùng API. PDF thử nghiệm miễn phí và có hình mờ; các công cụ sẽ yêu cầu trợ lý tạo PDF thử nghiệm trừ khi bạn yêu cầu tài liệu thực. Việc thiết lập trường cho mẫu mới tự động sử dụng số trang AI miễn phí hàng tháng trong tài khoản của bạn, sau đó dùng tín dụng, giống như trong trình chỉnh sửa mẫu.

Ví dụ về câu lệnh

Trong trợ lý trò chuyện:

• “Thiết kế mẫu chứng nhận hoàn thành có tên người nhận, khóa học và ngày tháng.”
• “Liệt kê các mẫu DocSpring của tôi và cho tôi xem các trường trong hợp đồng thuê.”
• “Tạo mẫu từ https://example.com/form.pdf, thiết lập các trường rồi cho tôi xem trang đầu tiên.”
• “Thiết kế hóa đơn một trang dưới dạng thiết kế trang, có bảng các khoản mục và tổng tiền, rồi cho tôi xem bản xem trước.”
• “Tạo PDF thử nghiệm từ mẫu hóa đơn cho Acme Corp, với ba khoản mục do bạn chọn.”
• “Đổi tên trường name trong mẫu hợp đồng thành full_name, rồi xuất bản phiên bản mới.”
• “Gửi mẫu NDA cho Jane rồi đến Sam ký theo thứ tự đó, với lời nhắc mỗi 3 ngày.”
• “Chuyển mọi mẫu có từ ‘Draft’ trong tên vào một thư mục mới tên là Drafts.”

Trong tác nhân lập trình, khi làm việc trong kho mã của ứng dụng:

• “Tạo mẫu DocSpring từ forms/application.pdf, thiết lập các trường và tạo kiểu TypeScript cho dữ liệu của mẫu.”
• “Viết mã dùng DocSpring SDK để điền mẫu onboarding của chúng ta từ hồ sơ khách hàng, rồi tạo PDF thử nghiệm để kiểm tra.”
• “Tạo PDF thử nghiệm từ mẫu hợp đồng thuê cho từng khách hàng trong fixtures/customers.csv.”

Các trợ lý cung cấp lời nhắc của máy chủ MCP dưới dạng lệnh cũng có Create a template, tính năng cùng bạn thiết kế mẫu mới từ mô tả hoặc từ PDF của bạn. Tính năng này khả dụng khi trợ lý có quyền ghi. Trong Claude Code, nhập / rồi tìm create_template: nếu máy chủ được thêm với tên docspring, lệnh sẽ là /mcp__docspring__create_template.

Bảo mật

• Trợ lý có quyền truy cập có thể đọc dữ liệu trong hồ sơ gửi của bạn, trong đó có thể bao gồm dữ liệu cá nhân. Chỉ kết nối những trợ lý mà tổ chức của bạn cho phép xử lý dữ liệu này.
• Nội dung trợ lý đọc, chẳng hạn như PDF trên web hoặc dữ liệu trong hồ sơ gửi, có thể chứa chỉ dẫn nhằm khiến trợ lý sử dụng sai công cụ. Hầu hết trợ lý sẽ hỏi trước khi gọi công cụ làm thay đổi nội dung; các công cụ chỉnh sửa hoặc xóa nội dung hiện có (chỉnh sửa mẫu hoặc trường, đổi tên, di chuyển, khôi phục phiên bản, thay đổi webhook hoặc tác vụ email, xóa, hết hạn) được đánh dấu là có tính phá hủy, vì vậy ứng dụng khách sẽ yêu cầu bạn xác nhận từng lần gọi. Chọn Read only nếu trợ lý chỉ cần xem.
• Với quyền truy cập đầy đủ, trợ lý quản lý webhook gửi dữ liệu trong hồ sơ gửi của bạn đến một URL và các tác vụ email gửi PDF của bạn qua email. Trợ lý có thể thay đổi tất cả các webhook và tác vụ email, kể cả những mục do chính bạn thiết lập; các mục được trợ lý thiết lập vẫn tiếp tục hoạt động sau khi bạn ngắt kết nối. Chọn Read and write nếu trợ lý không cần quản lý chúng.
• Trợ lý không bao giờ thấy khóa bí mật ký của webhook hoặc giá trị trong các tiêu đề của webhook: hãy sao chép khóa bí mật từ trang webhook trong DocSpring (Webhooks trên thanh bên) và thêm tiêu đề tại đó.

Khắc phục sự cố

Trợ lý không có công cụ của DocSpring. Chỉ thêm máy chủ là chưa đủ: bạn cũng cần đăng nhập. Trong Claude, nhấp Connect bên cạnh DocSpring trong Customize > Connectors, rồi bật tính năng này cho cuộc trò chuyện từ menu +. Trong Claude Code, chạy /mcp rồi chọn docspring (docspring-eu cho EU). Trong Codex, chạy codex mcp login docspring (hoặc docspring-eu).

Đăng nhập không nhận ra tài khoản của bạn hoặc không thấy các mẫu. Bạn đã kết nối máy chủ của khu vực còn lại. Nếu bạn đăng nhập tại app-eu.docspring.com, hãy kết nối https://mcp-eu.docspring.com/mcp và đặt tên là docspring-eu; nếu không, hãy dùng https://mcp.docspring.com/mcp.

Thiếu công cụ bạn mong đợi. Trợ lý chỉ có những công cụ được phép theo quyền truy cập: Read only không có công cụ nào có thể thay đổi nội dung. Để thay đổi quyền truy cập, hãy ngắt kết nối trợ lý trong Connected apps trên trang Integrations rồi đăng nhập lại. ChatGPT Pro chỉ có các công cụ chỉ đọc, bất kể bạn chọn tùy chọn nào.

Công cụ mới không xuất hiện. Một số trợ lý lưu danh sách công cụ mà chúng thấy khi bạn kết nối. Hãy kết nối lại DocSpring hoặc làm mới trong phần cài đặt trình kết nối của trợ lý.

Trợ lý đã bị đăng xuất. Điều này xảy ra khi có người trong tài khoản ngắt kết nối trợ lý trong DocSpring hoặc khi trợ lý không được sử dụng trong 90 ngày. Hãy đăng nhập lại từ trợ lý: trong Claude, nhấp Reconnect bên cạnh DocSpring trong Customize > Connectors.

Một công cụ trả về processing. PDF hoặc mẫu mất hơn khoảng 50 giây để xử lý. Yêu cầu trợ lý kiểm tra lại: trợ lý sẽ dùng get_submission hoặc get_template.

Tạo PDF thực tế không thành công do lỗi tín dụng. PDF thực tế sử dụng tín dụng trong tài khoản của bạn. Hãy thêm tín dụng trên trang Billing. Nếu lỗi cho biết PDF sẽ được xử lý sau khi bạn thêm tín dụng, PDF sẽ được tạo khi đó, vì vậy đừng yêu cầu tạo lại. PDF thử nghiệm miễn phí trong lúc bạn dùng thử, nhưng việc kết hợp PDF luôn sử dụng tín dụng.

Nếu cần hỗ trợ về vấn đề khác: gửi email đến [email protected] hoặc dùng biểu mẫu liên hệ.

Công cụ máy chủ MCP Từng công cụ và quyền truy cập cần có