Tally MCP Server

chính thức

Tạo và chỉnh sửa biểu mẫu Tally, phân tích các bài gửi

Xem trên tally.so

Tài liệu

Máy chủ MCP

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

Máy chủ Tally MCP 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 phản hồi bằng ngôn ngữ tự nhiên thông qua các trợ lý AI như Claude.

URL Máy chủ

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

https://api.tally.so/mcp

Xác thực

Máy chủ Tally MCP 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ợ trình 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 Tùy chỉnh > Trình kết nối > Thêm trình kết nối tùy chỉnh từ thanh bên trái. Claude connectors
  2. Đặt tên cho trình kết nối và URL máy chủ Tally MCP.
https://api.tally.so/mcp
  1. Nhấp "Thêm" để lưu trình kết nối. Add Tally MCP connector
  2. Khởi động lại Claude Desktop
  3. Lần đầu tiên bạn sử dụng máy chủ Tally MCP, Claude sẽ mở quy trình 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ủ Tally MCP, hãy 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ý quy trình OAuth khi bạn sử dụng máy chủ Tally MCP lần đầu tiên. 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ở Cài đặt Cursor > Công cụ & MCP
  2. Nhấp Máy chủ MCP Mới
  3. Dán JSON sau để cấu hình máy chủ Tally MCP:
{
  "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 của mình 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 một 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.

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 nó bằng cách tiếp tục:

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 và lưu nó.

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

Ngoài ra, bạn có thể nêu rõ chính xác những 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 một biểu mẫu với các trường được chỉ định và lưu nó.

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, thực hiện các thay đổi được yêu cầu và lưu phiên bản đã cập nhật.

Lấy phản hồi biểu mẫu

Bạn có thể lấy phản hồi cho bất kỳ biểu mẫu nào, với các 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ẽ lấy và hiển thị các phản hồ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ê các 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 thời gian 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 các 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ủ Tally MCP sử dụng OAuth với Claude