Tally

Máy chủ MCP

Xây dựy biểu mẫu Tally và liệt kê biểu mẫu hoặc bài gửi bằng trợ lý AI thông qua Giao thức Ngữ cảnh Mô hình (Model Context Protocol)

Máy chủ MCP Tally hiện đang trong giai đoạn beta và có thể thay đổi.

MCP là gì?

Giao thức Ngữ cảnh Mô hình (MCP) cho phép bạn xây dựng biểu mẫu Tally và truy xuất biểu mẫu hoặc bài gửi bằng ngôn ngữ tự nhiên thông qua trợ lý AI như Claude.

URL máy chủ

Máy chủ MCP Tally có sẵn tại:

https://api.tally.so/mcp

Xác thực

Máy chủ MCP Tally hỗ trợ hai phương thức xác thực:

Tùy chọn 1: OAuth (Khuyến nghị)

Cách dễ nhất để kết nối là thông qua OAuth. Nhiều trợ lý AI hỗ trợ xác thực OAuth cho máy chủ MCP, cho phép bạn kết nối chỉ với vài cú nhấp chuột mà không cần quản lý khóa API thủ công.

Khi trợ lý AI của bạn nhắc xác thực OAuth:

1. Nhấp vào nút kết nối hoặc liên kết ủy quyền
2. Đăng nhập vào tài khoản Tally của bạn (nếu chưa đăng nhập)
3. Ủy quyền kết nối
4. Trợ lý AI sẽ tự động cấu hình kết nối

Tùy chọn 2: Khóa API

Bạn cũng có thể xác thực bằng khóa API trong tiêu đề Authorization:

Authorization: Bearer tly-xxxx

Tìm hiểu thêm về cách lấy khóa API của bạn.

Cấu hình

Claude Desktop

Phương pháp này hoạt động cho Claude Desktop và claude.ai, và áp dụng trên tất cả các ứng dụng Claude hỗ trợ bộ kết nối, bao gồm Claude Chat, Claude Code và Claude Cowork.

1. Mở Claude Desktop (hoặc claude.ai trong trình duyệt của bạn) và điều hướng đến Customize > Connectors > Add custom connector từ thanh bên trái.
2. Đặt tên cho bộ kết nối và URL máy chủ MCP Tally.

https://api.tally.so/mcp

3. Nhấp "Add" để lưu bộ kết nối.
4. Khởi động lại Claude Desktop
5. Lần đầu tiên bạn sử dụng máy chủ MCP Tally, Claude sẽ mở luồng OAuth để xác thực với tài khoản Tally của bạn.

Claude Code CLI

Để kết nối Claude Code với máy chủ MCP Tally, chạy lệnh sau trong terminal của bạn:

claude mcp add tally --transport http https://api.tally.so/mcp

Claude Code sẽ tự động xử lý luồng OAuth khi bạn sử dụng máy chủ MCP Tally lần đầu. Bạn có thể xác minh kết nối bằng cách chạy lệnh /mcp bên trong Claude Code.

Cursor

1. Mở Cursor Settings > Tools & MCP
2. Nhấp New MCP Server
3. Dán JSON sau để cấu hình máy chủ MCP Tally:

{
  "mcpServers": {
    "tally": {
      "url": "https://api.tally.so/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Ví dụ sử dụng

Sau khi được cấu hình, bạn có thể yêu cầu trợ lý AI tạo biểu mẫu bằng ngôn ngữ tự nhiên. Dưới đây là một số ví dụ:

Tạo biểu mẫu liên hệ đơn giản

Create a simple contact form

Trợ lý AI sẽ tự động tạo biểu mẫu liên hệ với các trường thường được mong đợi dựa trên hiểu biết của nó về những gì một biểu mẫu liên hệ điển hình nên bao gồm. Biểu mẫu mới vẫn là bản nháp riêng tư cho đến khi bạn yêu cầu trợ lý xuất bản chúng.

Cập nhật biểu mẫu liên hệ

Nếu biểu mẫu được tạo không chính xác như bạn muốn, bạn có thể dễ dàng sửa đổi bằng cách theo dõi:

We don't need the Company field, remove the consent checkbox and maybe add a captcha

Trợ lý AI sẽ sửa đổi biểu mẫu một cách chính xác. Mọi thay đổi được lưu ngay lập tức.

Tạo biểu mẫu với các trường cụ thể

Ngoài ra, bạn có thể chỉ định rõ ràng chính xác các trường bạn muốn:

Create a contact form with these specific fields:
- Name (required)
- Email (required)
- Phone (optional)
- Message (required)
- Captcha (required)

Trợ lý AI sẽ tạo biểu mẫu nháp với các trường được chỉ định. Yêu cầu nó xuất bản biểu mẫu khi bạn muốn chia sẻ.

Cập nhật biểu mẫu hiện có

Update this form https://tally.so/r/a1B2c3
- Remove the phone number field
- Also add a captcha
- Make company field optional

Trợ lý AI sẽ sử dụng các công cụ MCP để tải biểu mẫu của bạn và thực hiện các thay đổi được yêu cầu. Trên biểu mẫu trực tiếp, các thay đổi về câu hỏi và nội dung (bao gồm logo, ảnh bìa và văn bản nút gửi) vẫn chưa được xuất bản cho đến khi bạn yêu cầu trợ lý xuất bản chúng, trong khi cài đặt và kiểu dáng khác được áp dụng ngay lập tức.

Truy xuất bài gửi biểu mẫu

Bạn có thể truy xuất bài gửi cho bất kỳ biểu mẫu nào, với bộ lọc tùy chọn cho trạng thái và phạm vi ngày:

Show me all completed submissions for https://tally.so/r/a1B2c3 from January 2025

Trợ lý AI sẽ truy xuất và hiển thị các bài gửi phù hợp cho biểu mẫu của bạn, bao gồm nhãn câu hỏi và dữ liệu phản hồi.

Liệt kê biểu mẫu

Bạn có thể liệt kê biểu mẫu trên các không gian làm việc có thể truy cập của mình và yêu cầu lọc theo tên, trạng thái hoặc mức độ gần đây:

Show my 10 most recently updated published forms

Trợ lý AI sẽ gọi công cụ liệt kê biểu mẫu MCP và trả về các biểu mẫu phù hợp với chi tiết chính như tên biểu mẫu, URL, trạng thái và ngày cập nhật cuối cùng.

Ví dụ sử dụng với Claude

Cấu hình máy chủ MCP Tally bằng OAuth với Claude Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.