MCP工具调用：HTTP_token

[nct_liuhaonan]

通过 Feishu App（飞书企业自建应用） 调用 多维表格 Bitable API 的完整流程指南。本教程包含创建应用、申请权限、授权表格、配置查询/新建数据的 MCP 工具等，并提供丰富格式、示例及注意事项。

---

什么是 Bitable API？

飞书多维表格（Bitable）是企业内常用的数据管理组件，可通过 API 实现数据的创建、查询、更新、删除。本教程主要讲解企业内部通过 自建应用 访问表格数据的方式。

官方文档参考：
https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview

---

1. 创建飞书企业自建应用

点击展开查看详细步骤

Step 1. 打开开发者后台

访问飞书应用后台：
开发者后台 - 飞书开放平台

Step 2. 创建企业自建应用

填写应用名称、描述后点击 创建

Step 3. 配置 API 权限

使用批量导入 JSON 的方式更快捷：

{
  "scopes": {
    "tenant": [
      "base:record:create",
      "base:record:retrieve",
      "bitable:app"
    ],
    "user": []
  }
}

点击 申请开通。

Step 4. 发布版本

1. 新建版本 → 版本号示例：1.0.0
2. 填写变更说明
3. 点击 保存 → 确认发布

Step 5. 获取 APP ID & APP Secret

后续调用 API 时必需。

---

2. 允许应用访问多维表格（Bitable）

点击展开查看授权方法

Step 1. 打开表格 → 更多 → 添加文档应用

这样才能让自建应用真正获得读取/写入该表格的权限。

---

3. 配置飞书动态 Token

点击展开查看步骤与示例

因为飞书应用的token是动态的，根据官方文档，动态获取token
参考获取token的官方API：自建应用获取 tenant_access_token - 服务端 API - 飞书开放平台

获取 tenant_access_token（internal）

请求 URL

https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal

请求头配置

Content-Type:"application/json; charset=utf-8"

请求参数（Body JSON）

（使用先前的 APP ID 和 Secret）

参数名	类型	必填	说明
app_id	string	是	应用唯一标识
app_secret	string	是	应用秘钥

示例：

{
  "app_id": "cli_xxx",
  "app_secret": "xxx"
}

返回参数（Response JSON）

字段名	类型	说明
code	int	错误码，0 表示成功
msg	string	错误消息或 “ok”
tenant_access_token	string	租户访问 token
expire	int	过期时间（秒），通常为 7200

示例：

{
  "code": 0,
  "msg": "ok",
  "tenant_access_token": "t-xxxxxx",
  "expire": 7200
}

token的位置在：tenant_access_token
官方token超时时间：7200s=7200000ms
配置在MCP token上的格式：

---

4. 配置查询数据的 MCP 工具（search）

点击展开查看步骤与示例

Step 1. 配置查询 MCP

官方查询 API：
查询记录 - 服务端 API - 飞书开放平台
请求地址为拼接url，请求filter等内容参考官方文档

{
  "filter": {
    "conjunction": "and",
    "conditions": [
      {
        "field_name": "多维表字段名1",
        "operator": "is",
        "value": [
          "{{age}}"
        ]
      },
      {
        "field_name": "多维表字段名2",
        "operator": "is",
        "value": [
          "{{name}}"
        ]
      }
    ]
  }
}

请求头配置

Content-Type:"application/json; charset=utf-8"

Step 2. 字段映射（非常重要）

用于将 Bitable 的字段名称映射到 MCP 返回的数据结构。

---

5. 配置新建记录的 MCP 工具（create）

查看创建数据方法

基本逻辑与查询相同，只是 API 地址和传参不同。
参考官方文档：
新增记录 - 服务端 API - 飞书开放平台

---

6. 常见问题 FAQ

为什么配置好权限仍然无权访问？

原因通常是：

• 未在目标表格中添加“文档应用”
• 使用了错误的应用版本（未发布）
• 使用了错误的 app_token / table_id

Bitable 中字段必须写英文吗？

不需要，飞书支持中文字段，MCP 中映射即可。

Token 会过期吗？

• tenant_access_token 有效期为 2 小时
• 建议在 MCP-token 中配置自动刷新

---