TechFabric

官方

搜索并阅读 TechFabric 已发布的 Databricks 和 AI 内容:包含常见问题的博客文章、服务页面和案例研究。阅读为匿名;TechFabric 员工使用 Microsoft 登录以起草文章。

你可以用 TechFabric MCP 做什么?

  • Databricks 以可运行的代码作答 — 提出一个 Databricks 问题,即可获得解答该问题的 Field Guide 章节,其中包含代码和引用的文档页面。
  • 搜索和阅读 Field Guide — 搜索指南章节,以 Markdown 形式阅读某一章或某一节,或列出目录。
  • 查找代码示例 — 获取某个主题的 SQL、Python、CLI 和配置代码块,每个代码块都附带其周围的说明和文档链接。
  • 跟踪 Databricks 的最新变更 — 查看自指定日期以来 Databricks 的新增内容,按从新到旧排列,包括发布阶段变更和已更新的章节。
  • 搜索和阅读 techfabric.com — 搜索该网站、阅读页面、列出博客文章,或查询 TechFabric 提供的内容。
  • 起草和发布文章(作者) — 登录后,对草稿进行 lint、检查、提交、更新和发布,或修订已发布的文章。

托管 MCP 服务器

npx add-mcp 'https://www.techfabric.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

TechFabric 的 MCP 服务器

编码代理所编写的 Databricks 代码,依据的是几个月前的训练数据。我们的 Field Guide 的 MCP 服务器会为 Claude Code、Codex、Cursor、VS Code 或任何 MCP 客户端提供能回答该问题的章节,并附带可运行的代码。第二个服务器 techfabric.com,是我们的工程师用他们已经在用的代理来撰写内容的地方。两者都免费。

连接你的代理

两者都是远程 Streamable HTTP 服务器:无需安装,阅读也无需登录。

1 · 选择一个服务器

Databricks Field Guide

Databricks 的答案来自我们 Field Guide 中可运行的代码,以及每个章节所引用的 docs.databricks.com 页面。

https://databricks.techfabric.com/mcp

techfabric.com

供 TechFabric 的工程师用他们的代理撰写文章和案例研究。任何人都可以搜索和阅读本站内容。

https://www.techfabric.com/mcp

2 · 将其添加到你的代理

如何连接 Claude Code

在任意终端中,每条命令各运行一次。添加 --scope user 即可在每个项目中都可用。

claude mcp add --transport http techfabric https://www.techfabric.com/mcp
claude mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcp

如何连接 Claude Desktop 和 claude.ai

  1. 打开 Customize,然后打开 Connectors,选择 Add,再选择 Add custom connector。
  2. 为其命名并粘贴服务器的 URL。保留 Claude 检测到的身份验证设置。
  3. 选择 Add。对第二个服务器重复此操作。

在 Team 或 Enterprise 套餐中,可能需要由所有者先为组织添加自定义连接器。

如何连接 Codex

Codex 会将它们写入 ~/.codex/config.toml,其 IDE 扩展也会读取该文件。

codex mcp add techfabric --url https://www.techfabric.com/mcp
codex mcp add databricks-field-guide --url https://databricks.techfabric.com/mcp

techfabric.com 为其作者工具提供登录,因此当你添加它时,Codex 可能会为 techfabric 启动一次登录。跳过它:所有读取工具都无需登录即可使用。要手动编辑该文件,请添加以下内容。

[mcp_servers.techfabric]
url = "https://www.techfabric.com/mcp"

[mcp_servers.databricks-field-guide]
url = "https://databricks.techfabric.com/mcp"

如何连接 Cursor

将此内容添加到 ~/.cursor/mcp.json 以应用于每个项目,或添加到某个项目中的 .cursor/mcp.json。

{
  "mcpServers": {
    "techfabric": { "url": "https://www.techfabric.com/mcp" },
    "databricks-field-guide": { "url": "https://databricks.techfabric.com/mcp" }
  }
}

如何连接 VS Code

将此内容添加到工作区中的 .vscode/mcp.json,然后从该文件或 MCP 视图中启动服务器。这些工具会出现在 Copilot 的代理模式中。

{
  "servers": {
    "techfabric": { "type": "http", "url": "https://www.techfabric.com/mcp" },
    "databricks-field-guide": { "type": "http", "url": "https://databricks.techfabric.com/mcp" }
  }
}

如何连接 Gemini CLI

保留 --transport http,因为如果没有它,Gemini CLI 会将 URL 视为本地命令。--scope user 会为每个项目写入 ~/.gemini/settings.json;不添加它则写入项目的 .gemini/settings.json。

gemini mcp add --transport http --scope user techfabric https://www.techfabric.com/mcp
gemini mcp add --transport http --scope user databricks-field-guide https://databricks.techfabric.com/mcp

如果 gemini mcp list 将它们显示为已禁用,请信任该文件夹。手动操作时,设置文件采用以下内容。

{
  "mcpServers": {
    "techfabric": { "type": "http", "url": "https://www.techfabric.com/mcp" },
    "databricks-field-guide": { "type": "http", "url": "https://databricks.techfabric.com/mcp" }
  }
}

如何连接 GitHub Copilot CLI

每条命令各运行一次。Copilot CLI 会将它们保存到 ~/.copilot/mcp-config.json,适用于每个项目。

copilot mcp add --transport http techfabric https://www.techfabric.com/mcp
copilot mcp add --transport http databricks-field-guide https://databricks.techfabric.com/mcp

如何连接 OpenCode

每条命令会写入项目的 opencode.json,或使用 --global 写入全局配置。

opencode mcp add techfabric --url https://www.techfabric.com/mcp
opencode mcp add databricks-field-guide --url https://databricks.techfabric.com/mcp

手动操作时,配置文件采用以下内容。

{
  "mcp": {
    "servers": {
      "techfabric": { "type": "remote", "url": "https://www.techfabric.com/mcp" },
      "databricks-field-guide": { "type": "remote", "url": "https://databricks.techfabric.com/mcp" }
    }
  }
}

如何连接其他 MCP 客户端

将客户端指向该 URL,使用 Streamable HTTP 传输且无需身份验证。仅支持 stdio 的客户端可以通过 mcp-remote 桥接访问任一服务器,其命令如下。

npx mcp-remote https://databricks.techfabric.com/mcp

要手动尝试一个,向该 URL POST 一个 JSON-RPC tools/list,即可返回工具及其完整的输入和输出架构。

TechFabric 作者?撰写需要登录:设置你的 AI 工具链以为 techfabric.com 撰写内容。

面向 TechFabric 作者

设置你的 AI 工具链以为 techfabric.com 撰写内容

选择你已经在用的代理并按照其步骤操作,从添加服务器到发布你的第一篇文章。你需要一个在博客作者名单上的 techfabric.com Microsoft 账户;阅读则两者都不需要。

设置 Claude Code

推荐

一次安装即可添加服务器、七个命令和 techfabric-blog 技能,并在每次发布前询问你。

  1. 使用插件添加服务器

    在任意终端中运行此命令。它会从 GitHub(Fabric-Pro/techfabric-claude-plugin)添加 TechFabric 的插件市场并安装该插件,插件中带有服务器的地址,因此无需再添加其他内容。在 Claude Code 会话中,/plugin marketplace add Fabric-Pro/techfabric-claude-plugin 然后 /plugin install techfabric@techfabric 效果相同,而 /reload-plugins 会启用该插件。 如果无法访问 GitHub,第二行会从 techfabric.com 安装相同的插件。
    claude plugin marketplace add Fabric-Pro/techfabric-claude-plugin && claude plugin install techfabric@techfabric
    
    复制
    claude plugin marketplace add https://www.techfabric.com/mcp-servers/harness/claude-code/marketplace.json && claude plugin install techfabric@techfabric
    
    复制
  2. 查找命令

    输入 /techfabric: 即可查看它们:write-post、write-case-study、check、preview、publish、revise 和 status。你在命令后输入的任何内容都会传递给它。
  3. 尝试第一个提示

    在你想要撰写的仓库中,用你的主题运行该命令,或用你自己的话提问。
    /techfabric:write-post how we cut our Lakeflow job's cold start
    
    复制
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  4. 打开预览

    Claude Code 是一个终端,因此它会显示链接而不是页面。关于草稿的每个回答都以一行 Preview: 和该链接开头。打开它即可阅读 techfabric.com 将要发布的那篇文章,包括其封面和图表。若要在浏览器中编辑,请使用网站发送给你的邮件中的编辑器链接。
  5. 阅读后发布

    用草稿的 id 运行 /techfabric:publish。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告诉你任何仍然失败的地方。然后会以文章名称请你确认,之后才会正式上线。你确认后,文章会被合并并部署,你的代理可以给你上线链接。该插件还会要求你允许每次 publish_draft 调用,即使在自动模式下也是如此。
  6. 如果出现问题

    工具缺失或失败:输入 /mcp,选择 techfabric 并重新连接。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。在 /mcp 中,选择 techfabric 并选择 Re-authenticate,或选择 Clear authentication 并重新登录。 某个命令缺失:运行 claude plugin marketplace update techfabric,然后 claude plugin update techfabric@techfabric,并重启 Claude Code。 登录页面显示你的地址不在作者名单上:请让 Preetham Reddy 添加你。

设置 Claude Desktop 和 claude.ai

添加一次自定义连接器,即可在 claude.ai 和 Claude Desktop 中同样使用。

  1. 将服务器添加为自定义连接器

    打开 Customize,然后打开 Connectors,选择 Add,再选择 Add custom connector。将其命名为 techfabric,粘贴 URL(www.techfabric.com/mcp 和 techfabric.com/mcp 均可),保留 Claude 检测到的身份验证设置,然后选择 Add。在 Team 或 Enterprise 套餐中,所有者会先在 Organization settings 和 Connectors 下为所有人添加它,你可以在 Customize 和 Connectors 下找到它,并标记为 Custom。
    https://www.techfabric.com/mcp
    
    复制
  2. 在聊天中启用它

    无需安装。在聊天中,打开 + 菜单,然后打开 Connectors,确保 techfabric 已为该对话启用。
  3. 尝试第一个提示

    粘贴以下内容,换成你自己的主题,并附上它应参考的笔记或代码。
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  4. 打开预览

    Claude 会渲染 MCP Apps,因此服务器以应用形式发送的草稿会在对话中打开,并附带其检查结果。关于草稿的每个回答也以一行 Preview: 和该链接开头,打开后即可看到 techfabric.com 将要发布的那篇文章。
  5. 阅读后发布

    让 Claude 发布该草稿。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告诉你任何仍然失败的地方。然后会以文章名称请你确认,之后才会正式上线。你确认后,文章会被合并并部署,你的代理可以给你上线链接。
  6. 如果出现问题

    工具缺失:检查该连接器是否已在聊天的 + 菜单中启用,或打开 Customize、Connectors 并重新连接它。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。再次在该连接器上选择 Connect。其登录设置无法编辑,因此要更改它们,请移除该连接器并重新添加。 登录页面显示你的地址不在作者名单上:请让 Preetham Reddy 添加你。

设置 ChatGPT

一个自定义 MCP 服务器,在 chatgpt.com 上作为插件添加。

  1. 将服务器添加为插件

    前往 chatgpt.com/plugins,选择 +,然后选择 Add custom MCP server。将其命名为 techfabric,在 Connection 下粘贴 URL,身份验证选择 OAuth,然后选择 I understand and want to continue 和 Create as a plugin,并安装它。如果没有 Add custom MCP server,请询问你工作区的管理员。
    https://www.techfabric.com/mcp
    
    复制
  2. 将其添加到聊天

    无需安装,且 ChatGPT 没有针对该服务器的斜杠命令。在新聊天中,输入 @ 并选择 techfabric。
  3. 尝试第一个提示

    粘贴以下内容,换成你自己的主题以及它应参考的笔记。
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  4. 打开预览

    ChatGPT 会渲染 MCP Apps,因此服务器以应用形式发送的草稿会在对话中打开,并附带其检查结果。关于草稿的每个回答也以一行 Preview: 和该链接开头,打开后即可看到 techfabric.com 将要发布的那篇文章。
  5. 阅读后发布

    让 ChatGPT 发布该草稿。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告诉你任何仍然失败的地方。然后会以文章名称请你确认,之后才会正式上线。你确认后,文章会被合并并部署,你的代理可以给你上线链接。
  6. 如果出现问题

    工具缺失:开始一个新聊天,并再次用 @ 选择 techfabric。如果某个工具仍然不在,请在 chatgpt.com/plugins 上对其选择 Refresh。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。在 chatgpt.com/plugins 上再次连接该插件。 登录页面显示你的地址不在作者名单上:请让 Preetham Reddy 添加你。

设置 Codex

CLI,以及读取相同配置的 IDE 扩展。这些命令以技能形式提供,按名称调用。

  1. 添加服务器

    在任意终端中运行此命令。Codex 会将其写入 ~/.codex/config.toml,IDE 扩展也会读取该文件。
    codex mcp add techfabric --url https://www.techfabric.com/mcp
    
    复制
  2. 使用 Microsoft 登录

    运行 codex mcp login techfabric。浏览器会打开一个 techfabric.com 页面,其中会说明请求访问的应用及其访问权限的去向。选择 Continue with Microsoft,并使用你的 @techfabric.com 账户登录,该账户必须位于博客的作者列表中。登录状态最长可保持 30 天。
    codex mcp login techfabric
    
    复制
  3. 安装命令

    这会在 ~/.agents/skills 中为每个命令添加一个技能。只有当你指定技能名称时,Codex 才会运行它:输入 $techfabric-write-post,或输入 /skills 查看全部技能。
    curl -fsSL https://www.techfabric.com/mcp-servers/harness/install.sh | sh -s -- codex
    
    复制
  4. 尝试第一个提示

    在你想要撰写的仓库中,启动 codex 并带上你的主题运行该技能,或用你自己的话提问。
    $techfabric-write-post how we cut our Lakeflow job's cold start
    
    复制
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  5. 打开预览

    Codex CLI 目前尚不显示 MCP Apps。每个关于草稿的回答都会以一行 Preview: 和链接开头。打开该链接即可阅读 techfabric.com 发布时的文章样式,包括封面和图表。若要在浏览器中编辑,请使用网站发送给你的邮件中的编辑器链接。
  6. 阅读后发布

    输入 $techfabric-publish 并带上草稿的 id。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告知你任何仍然失败的地方。随后系统会要求你按文章名称进行确认,之后内容才会正式上线。你确认后,文章会被合并并部署,你的代理可以为你提供线上链接。
  7. 如果出现问题

    工具缺失:运行 codex mcp list 以确认 techfabric 存在且已启用,或在 Codex 中运行 /mcp,然后重启 Codex。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。再次运行 codex mcp login techfabric。 技能缺失:再次运行安装命令并重启 Codex。 登录页面提示你的地址不在作者列表中:请让 Preetham Reddy 将你添加进去。

设置 Cursor

在 Cursor 的 MCP 设置中添加服务器,并在你撰写所用的项目中以技能形式安装命令。

  1. 添加服务器

    将此内容添加到 ~/.cursor/mcp.json 以应用于所有项目,或添加到某个项目中的 .cursor/mcp.json。Cursor 会在其 Customize 页面中与其他 MCP 服务器一起列出该服务器。
    {
      "mcpServers": {
        "techfabric": { "url": "https://www.techfabric.com/mcp" }
      }
    }
    
    复制
  2. 安装命令

    在你撰写所用的项目中运行此命令。它会在 .cursor/skills 中将命令添加为技能,只有当你输入时才会运行,并在 .cursor/rules 中添加一条规则,将代理指向该服务器。
    curl -fsSL https://www.techfabric.com/mcp-servers/harness/install.sh | sh -s -- cursor
    
    复制
  3. 尝试第一个提示

    在代理中,输入命令并带上你的主题,或用你自己的话提问。
    /techfabric-write-post how we cut our Lakeflow job's cold start
    
    复制
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  4. 打开预览

    Cursor 会渲染 MCP Apps,因此服务器以应用形式发送的草稿会在对话中打开,并在一旁显示其检查结果。每个关于草稿的回答也会以一行 Preview: 和链接开头,打开该链接即可查看 techfabric.com 发布时的文章样式。
  5. 阅读后发布

    输入 /techfabric-publish 并带上草稿的 id。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告知你任何仍然失败的地方。随后系统会要求你按文章名称进行确认,之后内容才会正式上线。你确认后,文章会被合并并部署,你的代理可以为你提供线上链接。
  6. 如果出现问题

    工具缺失:在 Cursor 列出其 MCP 服务器的位置,检查 techfabric 是否已开启,并将其关闭再重新开启以重新连接。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。在 Cursor 列出该服务器的位置重新登录 techfabric。 命令缺失:在项目中再次运行安装命令并重新加载 Cursor。 登录页面提示你的地址不在作者列表中:请让 Preetham Reddy 将你添加进去。

设置 VS Code 与 GitHub Copilot

在 Copilot 的代理模式中添加服务器。其命令就是服务器自带的提示,因此无需安装其他内容。

  1. 添加服务器

    从命令面板运行 MCP: Add Server,选择 HTTP (HTTP or Server-Sent Events),粘贴 URL,将其命名为 techfabric 并选择保存位置。或者将此内容添加到工作区中的 .vscode/mcp.json。
    {
      "servers": {
        "techfabric": { "type": "http", "url": "https://www.techfabric.com/mcp" }
      }
    }
    
    复制
  2. 查找命令

    无需安装。在 Copilot Chat 的代理模式下,输入 /techfabric. 即可查看命令。VS Code 会逐一询问每个参数。
  3. 尝试第一个提示

    运行命令并给出你的主题,或用你自己的话提问。
    /techfabric.write-post
    
    复制
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  4. 打开预览

    当实验性的 chat.mcp.apps.enabled 设置开启时,VS Code 会在聊天中渲染 MCP Apps,因此服务器以应用形式发送的草稿会在对话中打开,并在一旁显示其检查结果。每个关于草稿的回答也会以一行 Preview: 和链接开头,打开该链接即可查看 techfabric.com 发布时的文章样式。
  5. 阅读后发布

    运行 /techfabric.publish 并带上草稿的 id。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告知你任何仍然失败的地方。随后系统会要求你按文章名称进行确认,之后内容才会正式上线。你确认后,文章会被合并并部署,你的代理可以为你提供线上链接。
  6. 如果出现问题

    工具缺失:运行 MCP: List Servers,选择 techfabric 并重启它。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。重启服务器并再次允许登录。账户菜单中的 Manage Trusted MCP Servers 会显示哪些服务器可以使用你的登录信息。 登录页面提示你的地址不在作者列表中:请让 Preetham Reddy 将你添加进去。

设置 Gemini CLI

为所有项目添加服务器。其命令就是服务器自带的提示,以斜杠命令形式提供。

  1. 添加服务器

    在任意终端中运行此命令。保留 --transport http:没有它,Gemini CLI 会将 URL 视为本地命令。
    gemini mcp add --transport http --scope user techfabric https://www.techfabric.com/mcp
    
    复制
  2. 使用 Microsoft 登录

    启动 gemini 并输入 /mcp auth techfabric。浏览器会打开一个 techfabric.com 页面,其中会说明请求访问的应用及其访问权限的去向。选择 Continue with Microsoft,并使用你的 @techfabric.com 账户登录,该账户必须位于博客的作者列表中。登录状态最长可保持 30 天。
    /mcp auth techfabric
    
    复制
  3. 查找命令

    无需安装。输入 /write-post、/publish 及其他命令,并按名称提供参数,例如 --topic 和 --id。
  4. 尝试第一个提示

    在你想要撰写的仓库中,带上你的主题运行命令,或用你自己的话提问。
    /write-post --topic="how we cut our Lakeflow job's cold start"
    
    复制
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  5. 打开预览

    Gemini CLI 是终端工具,因此它会显示链接而非页面。每个关于草稿的回答都会以一行 Preview: 和链接开头。打开该链接即可阅读 techfabric.com 发布时的文章样式,包括封面和图表。若要在浏览器中编辑,请使用网站发送给你的邮件中的编辑器链接。
  6. 阅读后发布

    运行 /publish --id=<the draft's id>。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告知你任何仍然失败的地方。随后系统会要求你按文章名称进行确认,之后内容才会正式上线。你确认后,文章会被合并并部署,你的代理可以为你提供线上链接。
  7. 如果出现问题

    工具缺失:输入 /mcp list。如果 techfabric 显示为已禁用,请运行 /mcp enable techfabric。如果 Gemini CLI 提示该文件夹不受信任,请信任你启动它时所在的文件夹,因为它在不受信任的文件夹中不会运行任何 MCP 服务器。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。再次输入 /mcp auth techfabric。 登录页面提示你的地址不在作者列表中:请让 Preetham Reddy 将你添加进去。

设置 Fabric Agents

你为每个步骤粘贴一行内容,你的 Fabric 代理会通过 fabric-cli 完成设置。

  1. 将服务器添加为源

    将此内容粘贴到 Fabric Agents 会话中。代理会将 techfabric.com 的 MCP 服务器添加为名为 TechFabric 的源,并使用 OAuth 登录。若还要每个工作日生成一篇草稿,请改为粘贴本页“每日草稿”下的 Fabric Agents 行。
    Add techfabric.com's MCP server to this workspace as a source: follow step 1 only of https://www.techfabric.com/mcp-servers/daily-drafts/fabric-agents.md
    
    复制
  2. 安装命令

    也粘贴此内容。代理会为每个命令添加一个技能,每个技能都需要 TechFabric 源。
    Add the TechFabric commands to this workspace: follow https://www.techfabric.com/mcp-servers/harness/fabric/README.md
    
    复制
  3. 尝试第一个提示

    输入命令并带上你的主题,或用你自己的话提问。
    @techfabric-write-post how we cut our Lakeflow job's cold start
    
    复制
    Write a TechFabric blog post about how we <the problem you solved or the thing you built>. Ask me for anything you don't know instead of inventing it, and give me the preview link when it's filed.
    
    复制
  4. 打开预览

    Fabric Agents 不显示 MCP Apps。每个关于草稿的回答都会以一行 Preview: 和链接开头。打开该链接即可阅读 techfabric.com 发布时的文章样式,包括封面和图表。若要在浏览器中编辑,请使用网站发送给你的邮件中的编辑器链接。
  5. 阅读后发布

    输入 @techfabric-publish 并带上草稿的 id。你的代理会先用 check_draft 验证已保存的文本,这需要五到十分钟,并会告知你任何仍然失败的地方。随后系统会要求你按文章名称进行确认,之后内容才会正式上线。你确认后,文章会被合并并部署,你的代理可以为你提供线上链接。这些命令均不会从自动化流程中发布。
  6. 如果出现问题

    工具缺失:让代理运行 fabric-cli source validate techfabric,如果失败则再次对源进行身份验证。 已退出登录,或每次写入都要求你重新登录:你的 30 天已到期,或你的账户发生了变化。再次对 TechFabric 源进行身份验证。 命令缺失:再次粘贴第 3 步中的命令行。 登录页面提示你的地址不在作者列表中:请让 Preetham Reddy 将你添加进去。

服务器

TechFabric 的各个 MCP 服务器分别做什么?

Field Guide 用代码回答 Databricks 相关问题;它有五个只读工具。techfabric.com 有九个:五个供我们的作者使用,他们从自己的代理中检查和提交草稿;另外四个任何人都可以用来搜索和阅读网站。

Databricks Field Guide MCP 服务器

Databricks Field Guide 汇集了我们工程师在构建、运行 Databricks 以及为其付费方面的知识。询问如何添加 Unity Catalog 行过滤器时,代理会获取解释该内容的章节、该章节中的 SQL 函数,以及该章节引用的 docs.databricks.com 页面。Databricks 的官方文档仍是语法和限制方面的权威。

5 个工具

  • search_guide 搜索指南
  • get_chapter 阅读章节
  • get_code_examples 查找代码示例
  • whats_new Databricks 新特性
  • list_chapters 列出章节

登录

无。该服务器是公开且只读的,没有写入工具。

速率限制

每个 IP 地址每分钟 60 次调用,每小时 300 次。

新鲜度

每次部署指南时重建。每个回答都附带构建它的提交、每个页面的最后更改日期以及可缓存时长:新特性为 10 分钟,搜索为 15 分钟,章节和代码为 1 小时。

协议

基于 Streamable HTTP 的 MCP 修订版 2026-07-28。仍使用 2025-11-25 的客户端可在同一 URL 上获得服务。

注册表

com.techfabric.databricks/field-guide,版本 1.1.1。MCP Registry 条目 · Glama 列表 参数、返回值和资源

  • search_guide 读取

    搜索指南

    回答 Databricks 问题的指南章节。 返回值和参数 返回值 回答 Databricks 问题的章节、边注和事件,按最佳匹配优先排序,每项包含摘要片段、带章节锚点的 URL,以及页面最后变更时间。 参数 query(必填);kind:chapter、note、feature 或 event;limit 1 到 25,默认 10
  • get_chapter 读取

    读取章节

    以 Markdown 形式返回一个章节或其中一节,代码保持原样。 返回值和参数 返回值 以干净的 Markdown 形式返回一个章节或边注,代码保持原样,或返回其中一节,并附上大纲、单独列出的代码块、FAQ、日期及其引用的 docs.databricks.com 链接。 参数 slug(必填):如 lakebase 的 slug、路径或任意指南 URL;section:锚点或标题
  • get_code_examples 读取

    查找代码示例

    某个主题的 SQL、Python、CLI 和配置块。 返回值和参数 返回值 匹配某个主题的 SQL、Python、CLI 和配置块,每项附上其周围的说明、所属章节以及该章节引用的文档链接。 参数 topic(必填);lang 如 sql、python、bash、yaml、json 或 hcl;limit 1 到 25,默认 8
  • whats_new 读取

    Databricks 新动态

    指南追踪的近期 Databricks 变更,最新优先。 返回值和参数 返回值 指南追踪的近期 Databricks 变更,最新优先:边注、带 Databricks 文档和发行说明链接的发布阶段变更,以及已更新的章节。 参数 since(YYYY-MM-DD,默认最近 30 天);limit 1 到 200,默认 30
  • list_chapters 读取

    列出章节

    目录,以及每章的主要小节。 返回值和参数 返回值 按指南顺序排列的每个章节,包含其所属部分、摘要、日期、URL、Markdown URL 和主要小节,以及边注。 参数 无
  • fieldguide://llms.txt 每个章节、边注和功能页面,每项一行。
  • fieldguide://page/{+path} 任意已发布页面以 Markdown 形式返回,例如 fieldguide://page/guide/lakebase。

techfabric.com MCP 服务器

其主要用途是写作:工程师的智能体根据仓库和已有上下文起草文章,运行站点检查并提交,工程师阅读预览并确认后即可发布。工作流程见用你自己的智能体写文章。

其读取工具仅从已发布、可索引的页面作答,因此草稿、预览以及任何标记为 noindex 的内容绝不会出现在结果中。

12 个工具

  • search 搜索 techfabric.com
  • get_page 读取页面
  • list_posts 列出博客文章
  • get_services TechFabric 提供什么
  • get_brief 今日简报作者
  • lint_draft 检查草稿作者
  • check_draft 校验草稿作者
  • submit_draft 提交草稿作者
  • get_status 草稿状态作者
  • update_draft 保存对草稿的编辑作者
  • publish_draft 发布你的草稿作者
  • revise_post 修改已发布文章作者

登录

读取无需登录。写入工具面向 TechFabric 博客作者,他们使用 techfabric.com 租户中的 Microsoft (Office 365) 账户登录。不接受其他租户。

速率限制

每个 IP 地址每小时 300 次匿名调用。已登录调用按作者计数,每小时 600 次,其中最多 20 次新检查运行、6 次提交和 30 次保存。

新鲜度

索引在每次部署时从站点重建。资源可能缓存一小时,搜索结果缓存 15 分钟。

协议

基于 Streamable HTTP 的 MCP 修订版 2026-07-28。仍使用 2025-11-25 的客户端在同一 URL 上获得服务。

注册表

com.techfabric/techfabric。MCP Registry 条目 · Glama 列表

参数、返回值和资源

  • search 读取

    搜索 techfabric.com

    匹配的页面,最佳优先。 返回值和参数 返回值 匹配的博客文章、服务和解决方案页面、案例研究、城市页面和活动,最佳优先,每项包含标题、URL、摘要、日期、作者和类型。 参数 query(必填);type:post、service、solution、case_study、city、event 或 page;limit 1 到 25,默认 10
  • get_page 读取

    读取页面

    一个已发布页面以干净的 Markdown 形式返回,含其 FAQ。 返回值和参数 返回值 一个已发布页面以干净的 Markdown 形式返回,含其标题、搜索标题、描述、日期、作者、标签、以问答对形式呈现的 FAQ,以及其规范 URL。 参数 url_or_slug(必填):完整 URL、如 /services/databricks 的路径,或文章的 slug
  • list_posts 读取

    列出博客文章

    博客文章,最新优先,可按标签、作者或日期筛选。 返回值和参数 返回值 博客文章,最新优先。 参数 tag、author(名称或 slug)、since(YYYY-MM-DD);limit 1 到 100,默认 20
  • get_services 读取

    TechFabric 提供什么

    每个服务和产品页面,附其自身摘要。 返回值和参数 返回值 每个服务、解决方案、Databricks、AI、云、软件、加速器和产品页面,包含其名称、URL、类型和摘要,与线上页面所述完全一致。 参数 无
  • get_brief 作者

    今日简报

    每日草稿的今日主题,为你保留一天。 返回值和参数 返回值 每日草稿的今日主题,为已登录作者保留 24 小时:角度、要回答的搜索、来源、要链接的页面以及简报的 id。如果今日文章已交给同事、站点节奏已用完或没有适合你工作的内容,则会说明原因。 参数 无
  • lint_draft 作者

    检查草稿

    站点的基于规则的检查,约一秒完成。 返回值和参数 返回值 对文章运行站点的基于规则的检查,不使用模型,返回每个项的状态和发现,附每个发现所涉及的段落及处理建议。还返回 judge_rubric:评判式检查所使用的读者、问题和阈值。不提交任何内容。 参数 markdown(必填,含 frontmatter);images(名称);kind;sources;slug
  • check_draft 作者

    校验草稿

    完整检查,含我们的评判器,每份最终文本运行一次。 返回值和参数 返回值 运行编辑器的完整 Run checks,含评判式检查,返回每个项的状态和发现。提供草稿 id 时检查已保存的文本,publish_draft 需要此结果。完整运行需五到十分钟。 参数 id(已保存的草稿)或 markdown(含 frontmatter);images;wait_seconds 最高 50,默认 25
  • submit_draft 作者

    提交草稿

    以你的署名提交的草稿,附其预览。 返回值和参数 返回值 按原文以已登录作者的署名提交文章,构建预览并通过电子邮件将编辑器链接发送给作者。返回草稿的 id。 参数 title 和 markdown(必填);images
  • get_status 作者

    草稿状态

    草稿的状态、未通过的检查、base_sha 和链接。 返回值和参数 返回值 你自己的一个草稿:其状态、未通过项、最近一次检查运行、当前 Markdown、预览链接,以及发布后的线上链接。编辑器链接仅在你的电子邮件中。 参数 id(必填)
  • update_draft 作者

    保存对草稿的编辑

    草稿的新保存版本;预览将重建。 返回值和参数 返回值 在一两秒内保存你自己草稿的新版本,返回其 text_hash,即你下一次的 base_hash。提交和预览在后台跟进。它不运行任何检查,因此请先检查文本;带 id 的 check_draft 可立即对已保存文本运行。一分钟内的第二次保存可能会被要求重试,同时第一次正在提交。 参数 id、markdown 和 base_hash(base_hash 来自 get_status,或来自你上次保存;base_sha 也可用)
  • publish_draft 作者

    发布你的草稿

    你确认后,草稿上线到 techfabric.com。 返回值和参数 返回值 通过编辑器自带的 Publish 发布你自己的草稿,前提是带其 id 的 check_draft 已在已保存文本上通过。首次调用不会发布任何内容:系统会要求你确认,可在你的客户端中确认,或由你的智能体通过一次性确认完成。随后站点合并并部署它。 参数 id(必填);confirmation(仅在第二次调用时);override(要跳过发布的未通过措辞检查);confirm_via
  • revise_post 作者

    修改已发布文章

    线上文章的修订版,作为带预览的草稿。 返回值和参数 返回值 为已上线文章的作者或博客编辑打开修订版:一个以线上文本开始的草稿,附其自身预览。相同的工具可编辑、检查和发布它,发布后将在同一 URL、同一署名下替换线上文章。 参数 post(必填:文章的 URL 或 slug)
  • site://llms.txt 站点的语言模型地图。
  • site://page/{+path} 任意已发布页面以 Markdown 形式返回,例如 site://page/services/databricks。
  • site://search?query= 搜索工具的结果作为客户端可缓存的资源,可选 type。
  • techfabric://editorial/rules 作者智能体在起草前阅读的站内写作规则。

试一试

你可以向 TechFabric 的 MCP 服务器问什么?

对于 techfabric.com,主要是写作;对于 Field Guide,则是它涵盖的任何内容。首次使用时请指明服务器,以便智能体知道该调用哪些工具;之后它通常会自行选择。

面向 techfabric.com 服务器的提示词

  • “使用 techfabric 服务器,获取今日简报,并根据我们在此仓库中构建的内容起草文章,省略任何属于客户的内容。” 复制
  • “把我们在此仓库中构建的内容变成一篇面向 techfabric.com 的案例研究草稿。先阅读 techfabric editorial_rules 资源,告诉我其客户登记规则是否允许我们点名客户,并向我询问成果数据。以 kind "case-study" 运行 lint_draft,修复其发现的问题直到通过,然后用 submit_draft 提交并给我预览链接。” 复制
  • “用 submit_draft 将此草稿提交到 techfabric.com,并给我预览链接。” 复制
  • “用 check_draft 及其 id 校验我的 techfabric.com 草稿,如果通过,在我同意后用 publish_draft 发布它。” 复制
  • “在 techfabric.com 上搜索我们已写过的关于 Lakebase 的内容,以免新文章重复。” 复制

面向 Databricks Field Guide 服务器的提示词

  • “问 Databricks Field Guide 如何为每个拉取请求提供自己的 Lakebase 分支,并展示它使用的 CLI 命令。” 复制
  • “根据 Field Guide,Databricks 在过去两周有哪些变更?” 复制
  • “在 Field Guide 中查找 Unity Catalog 行过滤器的 SQL 示例,然后检查它们引用的 docs.databricks.com 链接以确认当前语法。” 复制
  • “列出 Field Guide 的章节,然后给我读 Lakebase 章节中关于为什么分支几乎不花成本的那一节。” 复制

工作原理

AI 智能体如何使用 MCP 服务器?

模型上下文协议 (MCP) 是 AI 助手用来调用其他系统上工具的开放标准。连接到 MCP 服务器的智能体可以在任务进行中查询信息并获得结构化答案,附上可引用的 URL,而无需根据其训练数据猜测或抓取网页。

你的 AI 智能体
Claude Code、Claude Desktop、
Cursor、VS Code

www.techfabric.com/mcp
search、get_page、
list_posts、get_services

databricks.techfabric.com/mcp
search_guide、get_chapter、
get_code_examples、
whats_new、list_chapters

写入工具、
仅限 TechFabric 作者
Microsoft 登录、
techfabric.com 租户

一篇草稿,署名
为作者本人,
由作者发布
来自编辑

链接至
docs.databricks.com
以获取准确语法
和限制

一个智能体,两个服务器。读取其中任何一个都无需登录;只有 techfabric.com 的写入工具会要求 TechFabric 作者使用 Microsoft 登录,而且两个服务器上的内容都不会被发布。

面向 TechFabric 作者

如何用自己的智能体撰写 TechFabric 博客文章

你的智能体会根据你实际做过的事情撰写文章,边写边检查,并在你阅读预览并表示同意后发布。撰写需要拥有 techfabric.com Microsoft 账户,且该账户在博客的作者名单中。

1 · 设置服务器

任何支持登录的 MCP 客户端都可以:Claude Code、Claude Desktop 和 claude.ai、Codex、Cursor、VS Code,或你自己的智能体。在 Claude Code 中,只需添加一次服务器,即可用于你的所有项目。

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

然后运行 /mcp,选择 techfabric 并选择 Authenticate。如果你跳过这一步,Claude Code 会在你的智能体首次调用写入工具时要求你登录。在 Claude Desktop 或 claude.ai 中,添加一个名为 techfabric 的自定义连接器,URL 如上,参见如何连接,然后选择 Connect。其他所有工具的分步说明都在设置你的 AI 工具中。

2 · 使用 Microsoft 登录

无论哪种方式,都会在浏览器中打开一个 techfabric.com 页面,其中说明发起请求的客户端及其访问权限的去向。选择 Continue with Microsoft,并使用你的 @techfabric.com 账户登录。访问权限持续一小时,并会自动续期 30 天。

一个可以使用的提示词

将占位符替换为你构建或修复过的内容。该提示词要求智能体先阅读规则。

Read techfabric.com's editorial rules (the techfabric editorial_rules resource), then write a TechFabric blog post about how we <solved this problem or built this thing>. Draft only from what I actually did and what's in this project; never name a client the rules don't approve, and ask me for any fact you don't have instead of inventing it. Run lint_draft and fix every finding until it passes, review the draft against the judge_rubric it returns, then submit it with submit_draft and give me the preview link.

用案例研究代替文章

  • 向 lint_draft、check_draft、submit_draft 和 update_draft 发送 kind "case-study"。预览是案例研究在 /case-studies/<slug> 的页面,其验证和发布方式与文章相同:用其 id 调用 check_draft,然后在你确认后调用 publish_draft,或通过编辑链接操作。
  • 其 frontmatter 为 title、description、sector、stack(列表)和 track(ai、migration 或 other)。当客户登记册批准在案例研究中点名该客户,或客户同意被点名时(见下文),添加 client。Logo、网站和指标永远不由你设置。
  • 其正文以四个部分开头,按顺序为:Challenge、Strategy、Solution、Results。每个部分以一句加粗的一句话论点开头,然后是正文。其他内容放在 Results 之后。
  • 如果没有已批准的客户,请按行业和规模匿名化("一家拥有约 40 家分行的区域性信用合作社"),并且任何地方都不要点名客户。要点名登记册未批准的客户,你需要客户的确认:用 client_confirmed: true 表示你已获得确认,或在编辑器中检查发现的条目上写"I have the client's confirmation to name..."。该确认会以你的名义记录。
  • 每个数字都是客户事实。你的智能体会向你询问结果数字,绝不编造或估算,检查会将每个数字与随案例研究发送的来源(你的笔记和项目自身的记录)进行核对。来源不等于批准:客户的指标只有在客户登记册中记录了批准,或 lib/work.ts 中已包含该指标时才会发布,而检查无法确认这一点,所以需要你在发布前确认。
Turn what we built in this repo into a case study draft for techfabric.com. Read the techfabric editorial_rules resource first, tell me whether its client register lets us name the client, and ask me for the outcome numbers. Run lint_draft with kind "case-study" and fix what it finds until it passes, then submit it with submit_draft and give me the preview link.

工作流程,分步说明

  1. 第 1 步

    阅读编辑规则

    你的智能体读取 editorial_rules 资源(techfabric://editorial/rules)。它以客户保密规则开头,该规则决定文章可以说什么,然后给出 frontmatter、此工作流程和内部写作规则。
  2. 第 2 步

    根据你自己的工作起草

    你的智能体根据它对你工作的了解(例如你所在的仓库和你的笔记)起草文章,包括 frontmatter。frontmatter 是必需的,至少要有 title 和 description:lint_draft、check_draft、submit_draft 和 update_draft 会拒绝没有 frontmatter 或没有 title 的文章。
  3. 第 3 步

    反复检查直到通过

    你的智能体对整篇文章运行 lint_draft。它对文本本身运行站点的基于规则的检查:slop 和禁用词规则、声明、已知错误、title 和 description、开头、FAQ、图表和图片。没有模型参与阅读,所以大约一秒就能返回结果。每条发现都会指出其所在段落和应如何处理,因此智能体会修复并再次检查,按需重复。
  4. 第 4 步

    对照评审的评分标准进行审查

    lint_draft 还会返回 judge_rubric:文章被评判时所面向的读者,包括他们已知的内容和试图解决的问题、我们的评审将提出的每个问题及其阈值,以及买家测试所读取的首屏。你的智能体以该读者的视角阅读草稿,以该读者的身份回答每个问题,并修改直到每个答案都达标。
  5. 第 5 步

    以你的署名提交

    你的智能体调用 submit_draft。文章会完全按原样以你自己的署名归档。站点会设置作者、今天的日期和 draft: true,并在缺失时添加阅读时间。它会渲染图表、绘制封面和分享图片、构建品牌预览并通过电子邮件发送给你。智能体会收到草稿的 id,随后用 get_status 跟进,并在每次提交和每次更新后向你展示预览链接。
  6. 第 6 步

    使用 update_draft 修改

    对于修改,你的智能体会先检查新文本,然后用 id、完整的新文章和来自 get_status 的 base_hash 调用 update_draft(base_sha 也可以)。保存会在几秒内返回,不运行任何检查;预览会在后台重新构建。如果草稿自该 base_hash 以来已发生变化,或草稿正在浏览器编辑器中打开,update_draft 会被拒绝。
  7. 第 7 步

    对已保存的文本验证一次

    预览上线后,你的智能体用草稿的 id 调用 check_draft。这是编辑器对确切已保存文本的完整 Run checks,包括我们的评审,需要五到十分钟。这是唯一会让我们产生成本的检查,对相同文本的重新检查会从缓存中返回结果。之后如果再次保存,就意味着需要重新验证。
  8. 第 8 步

    在你确认后发布

    你的智能体用 id 调用 publish_draft,第一次调用不会发布任何内容。你的客户端会向你询问并指明文章,或你的智能体获得一次性确认,并在你同意后才发回。如果你的客户端显示草稿卡片,你回答一次其问题,然后客户端会请求你允许发布。文章随后会经过编辑器自身的 Publish and deploy;如果失败,草稿会恢复。

我们这边做与不做的事

你的文本就是草稿。我们的博客写手不会重写它,也没有模型对其进行事实核查,因此事实需要你的智能体在提交前对照供应商文档进行核查。编辑规则中提到博客写手事实核查的地方,该步骤不会对你的文章运行。站点的检查仍会约束它,包括声明和已知错误检查,这些必须始终通过。

如果只有措辞和风格检查未通过,你仍然可以发布,从编辑器中发布,或向 publish_draft 指明这些检查,该选择会被记录。保持页面正常工作的检查(构建、图片、图表、链接、占位符)以及关于声明、我们自身支出和密钥的规则必须始终通过。

将你的修改保留在你的智能体和 update_draft 中,除非你希望写手参与。回复预览邮件则不同,因为回复会发送给我们的博客写手。如果写手随后需要只有你才掌握的事实,get_status 会向你询问,或者在支持 MCP 任务的客户端中,由打开的任务来询问。

需要了解的规则

  • 除非客户已获准发布,否则不得出现客户名称、数据、指标、schema、事件或代码,且仅限批准范围之内。编辑规则列出了哪些客户已获批准。当客户同意且你说明时(client_confirmed),也可以出现客户名称,且仅限名称。如有疑问,请泛化或省略。
  • 第一手声明必须真实。仅对我们做过的事情使用"我们",绝不要让智能体编造数字、结果、客户或引语。

在你的工具中查看

  • 在渲染 MCP Apps 的宿主中,草稿工具会在对话中打开文章,呈现 techfabric.com 将展示的样子,包括其封面、图表和 FAQ。
  • 旁边是检查项。每项显示其发现、相关段落,以及你是否可以越过它发布,还是它必须通过。
  • 你可以从那里再次运行检查。Ask the agent to fix this 会将一条发现交回给你的智能体,由它编辑并保存草稿,因此写作仍由智能体完成。
  • Publish 在已保存文本的检查通过后可用,并会先要求你确认。当只有措辞检查未通过时,Publish anyway 会在你确认前列出这些检查。你邮件中的编辑链接也可用,而应用从不显示它。 支持 MCP Apps 的宿主,依据 2026 年 10 月官方 MCP 客户端矩阵:Claude(claude.ai 和 Claude Desktop)、ChatGPT、带 GitHub Copilot 的 VS Code、Microsoft 365 Copilot、Cursor、Goose、Codex 桌面应用、Postman 和 MCPJam。在 Claude Code、Codex CLI 和 Fabric Agents 中,回答以文本形式返回,开头是预览链接。

修改已发布的文章

  • 你的智能体用文章的 URL 调用 revise_post。只有文章作者(署名所指的工程师)或博客编辑才能打开。它会打开一个修订版本,其初稿就是线上正文,位于独立分支并带有独立预览,同时通过电子邮件把预览和编辑链接发给你。对同一篇文章再次请求,会返回已经打开的修订版本。
  • 从那时起,它就和任何其他草稿一样。用修订版本的 id 调用 get_status 可获得 markdown 和 base_sha,你的智能体进行编辑并运行 lint_draft(带上文章的 slug)和 update_draft,然后用 id 调用 check_draft 验证已保存的文本,在你确认后由 publish_draft 发布。邮件中的编辑链接用法相同。
  • 发布会替换同一 URL 上的线上文章。署名保持不变,任何更改署名的保存或发布都会被拒绝。更改标题会保留 URL;更改线上 URL 需要重定向,因此请询问博客编辑。原始发布日期保持不变,页面会显示“Updated”及日期。站点地图的最后修改时间会更新,部署会把该 URL 提交给 IndexNow,因此搜索引擎可以看到文章已更改。
  • 即使只改一个词,也必须通过保持页面正常运行的检查,以及关于声明、我们自身支出和机密信息的规则。如果只有措辞和风格检查未通过,你可以照常发布,与新文章一样。
  • 如果在你的修订版本打开期间有人更改了线上文章,发布会停止,而不会覆盖它。线上文章的更改会连同你的更改一起进入你的草稿,凡是你们双方都改动了同一段落的地方,线上措辞会保留,你的措辞会列在草稿上。请阅读、保存、再次检查,然后发布。从修订版本邮件中的链接丢弃修订版本,线上文章保持原样。
  • 如果没有智能体,请在 https://www.techfabric.com/api/ideas/revise. 请求一个链接。如果你的地址可以编辑该文章,你会收到一个“Edit this post”链接,打开同一个修订版本。
Change my published post at <its URL on techfabric.com>: <what to change>. Open it with the techfabric revise_post tool, edit the markdown get_status returns, run lint_draft with the post's slug until it passes, save it with update_draft, verify it with check_draft and the id, then ask me before publish_draft.

故障排除

登录被拒绝

登录页面会说明原因。如果它说你的地址还不在 techfabric.com 的作者列表中,那就没有可供起草的署名,请让 Preetham Reddy 把你添加进去。如果它说只有 TechFabric 的 Microsoft 账户或只有 @techfabric.com 账户可以登录,或者访客账户不能登录,说明你用了另一个 Microsoft 账户登录;请用你自己的 @techfabric.com 账户重新登录。如果它说应用无法连接,说明客户端要求把其登录信息发送到 MCP 不允许的地方(以明文 http 发送到另一台计算机);请更新客户端。

某项检查一直失败

让你的智能体对文本运行 lint_draft:每条发现都会指出其所在段落以及该怎么做。在 check_draft 中失败的评判类检查(读者测试、有用内容)会附带其评分;让智能体依据 judge_rubric 修改,调用 update_draft,然后再次验证。你邮件中的编辑链接会显示相同的检查清单。

调用次数过多

登录后,每小时的上限为 600 次调用、240 次 lint、20 次新检查运行、6 次提交、6 次打开修订版本、30 次保存和 10 次发布。检查已经检查过的文本不计为新的运行。

其他问题

请询问负责该博客的 Preetham Reddy。

面向 TechFabric 作者

从你的智能体写作和发布的命令

你不必记住工具顺序。服务器自带 7 个命令,每个命令都会给你的智能体确切的步骤,并指向内部规则。大多数智能体会把它们显示为斜杠命令;对于不这样显示的智能体,我们以各自的格式提供相同的命令。

  • write-post 以你的署名起草一篇 techfabric.com 博客文章,依据今日简报或你自己的主题。你的智能体会向你询问第一手细节,检查草稿并归档;由你发布。
  • write-case-study 起草一篇关于你参与过的项目的 techfabric.com 案例研究。你的智能体会询问结果数据及其来源,并在提及登记册未批准的客户之前征求客户确认。
  • check 对草稿运行 techfabric.com 的检查,并用通俗语言解释每条发现,附上你的智能体建议的修复方案。在你同意之前不会有任何更改。
  • preview 以 techfabric.com 发布时的样子展示草稿:预览链接,或在渲染 MCP Apps 的宿主中显示草稿应用。
  • publish 把你的某篇草稿发布到 techfabric.com。你的智能体会检查它,告诉你还有什么未通过,并且只在你同意后才发布。
  • revise 把审阅者的反馈或你自己的更改应用到你的某篇草稿或已上线的文章,再次检查并保存,同时保持你的第一手事实不变。
  • status 列出你的草稿及每篇的状态,或详细列出一篇草稿:什么未通过、其预览以及下一步该做什么。

初次使用该服务器?请先设置你的 AI 工具链,从添加服务器到登录。publish 总是先询问你,而且它们在定时运行中都不会发布。在允许附加资源的智能体中,你还可以把今日简报(techfabric://brief/today)或你的某篇草稿(techfabric://drafts/<id>)附加到消息中。

你的智能体中的命令

Claude Code

一个插件:服务器、命令和 techfabric-blog 技能一次安装完成。

claude plugin marketplace add Fabric-Pro/techfabric-claude-plugin && claude plugin install techfabric@techfabric

然后运行 /mcp,选择 techfabric,选择 Authenticate 并登录。输入 /techfabric: 查看命令。命令之后的所有内容都会传递给它,因此 /techfabric:write-post how we cut Lakeflow cold starts 可按原样使用。在每次 publish_draft 之前,插件都会请求你允许,即使在自动模式下也是如此。不使用插件时,服务器自带的提示会显示为 /techfabric:write-post (MCP) 等,但 Claude Code 会在每个空格处拆分它们的参数。

该插件发布在 GitHub 上,地址为 Fabric-Pro/techfabric-claude-plugin。如果未安装 git,请改为从 techfabric.com 添加:

claude plugin marketplace add https://www.techfabric.com/mcp-servers/harness/claude-code/marketplace.json && claude plugin install techfabric@techfabric

例如

/techfabric:write-post today's brief

Codex

输入 $techfabric-write-post 及其余内容:每个命令一个技能,仅在你指定时运行。

curl -fsSL https://www.techfabric.com/mcp-servers/harness/install.sh | sh -s -- codex

它们放在 ~/.agents/skills 中,每个命令一个技能,Codex 仅在你指定某个技能时运行它们:输入 $techfabric-write-post,或输入 /skills 查看全部。服务器本身按如何连接中的说明添加。

例如

$techfabric-write-post today's brief

Cursor

作为斜杠命令运行的技能,以及一条规则,放在你写作所用的项目中。

curl -fsSL https://www.techfabric.com/mcp-servers/harness/install.sh | sh -s -- cursor

在你写作所用的项目中运行它。它会把命令作为技能添加到 .cursor/skills 中,仅在你输入时运行,并在 .cursor/rules 中添加一条规则,让智能体指向该服务器。

例如

/techfabric-write-post today's brief

VS Code

服务器自带的提示,在 Copilot Chat 中。除服务器外无需安装任何东西。

在 Copilot Chat 中输入 /techfabric.write-post。VS Code 会询问每个参数并建议取值,例如登录后你自己的草稿 id。

例如

/techfabric.write-post

Gemini CLI

服务器自带的提示,作为带命名参数的斜杠命令。

输入 /write-post --topic="today's brief"。参数为 --topic、--project、--client、--id 和 --feedback,按各命令所需的方式传入。

例如

/write-post --topic="today's brief"

Fabric Agents

在已把 techfabric.com 的 MCP 服务器添加为源的工作区中,输入 @techfabric-write-post 及其余内容。

Add the TechFabric commands to this workspace: follow https://www.techfabric.com/mcp-servers/harness/fabric/README.md

智能体会为每个命令添加一个技能。然后输入 @techfabric-write-post。它们都不属于自动化:每日运行使用 techfabric-blog 技能,该技能从不发布。

例如

@techfabric-write-post today's brief

面向 TechFabric 作者

来自你的编码智能体的每日草稿

你的智能体可以在每个工作日上午 9 点为你开始一篇文章。服务器每天从新闻和我们希望回答的搜索中挑选一个主题,将其与你所写的内容匹配,并为你保留一天。你的智能体会根据你的代码仓库起草,并为你留下关于第一手部分的问题。你补充这些内容,阅读并决定是否发布。

  1. 第 1 步

    获取今日简报

    在工作日上午 9 点,你的调度器以 techfabric-blog 技能启动你的智能体。智能体调用 get_brief,它会挑选今日主题并为你保留 24 小时:过去两天的新闻故事,或一个我们尚未回答、与你的工作匹配的搜索。如果今日的文章已交给同事、每天一篇自动文章和每周三篇的节奏已用完,或没有合适的内容,它会说明原因并停止。
  2. 第 2 步

    根据你自己的作品起草

    智能体读取 editorial_rules 资源,并根据简报和运行起始所在的代码仓库起草。它会向你询问只有你知道的内容,例如出了什么问题或你测得的某个数字。在无人值守运行时,它会以 TechFabric 的“we'd”语气写作,并在链接旁列出它为你准备的问题。
  3. 第 3 步

    Lint、修复并提交

    智能体运行 lint_draft 并修复其报告的问题直到通过,依据它返回的 judge_rubric 审阅草稿,然后用简报的 id 调用 submit_draft。文章会以你的署名归档,站点会构建预览。定时运行到此为止:技能会告诉它绝不发布,下面的 Claude Code 和 Codex 调度都省略了 publish_draft。
  4. 第 4 步

    审阅并发布

    运行结束时会在其会话中(对于来自 cron 的运行,则在其日志中)给出预览链接和智能体的问题。你阅读预览并回答智能体所问的内容。然后,在与你的会话中,智能体用 check_draft 验证并调用 publish_draft,后者会请求你确认。或者使用预览邮件中的编辑链接。在你同意之前不会发布任何内容。

在你的智能体中安排定时

Fabric Agents

每个工作日,运行会打开自己的会话,等待你允许其工具,并以 Needs Review 状态结束,附上预览链接。

把以下内容粘贴到 Fabric Agents 会话中:

Set up TechFabric daily drafts in this workspace: follow https://www.techfabric.com/mcp-servers/daily-drafts/fabric-agents.md

智能体会把 techfabric.com 的 MCP 服务器添加为源、添加 techfabric-blog 技能,以及一个在你所在时区每个工作日上午 9 点运行的自动化,使用你已有的模型连接。然后验证 TechFabric 源并用你的 @techfabric.com 账户登录。该自动化以 Ask 模式运行,因此每次运行都会等待你允许其工具。如果你希望它无需询问即可运行,请将其切换为 Execute。

Claude Code

一个 Desktop 定时任务,或用于 CLI 的一行 cron。

curl -fsSL https://www.techfabric.com/mcp-servers/daily-drafts/install.sh | sh -s -- claude-code

然后运行 /mcp,选择 techfabric,选择 Authenticate 并登录。在 Claude Desktop 的 Code 标签页中,打开 Scheduled,在 Weekdays 的 9:00 添加一个本地任务,位于你的某个代码仓库中,并以以下内容作为其指令。选择一次 Run now,并始终允许 techfabric 工具。

Draft today's TechFabric post with the techfabric-blog skill.

没有 Desktop 时,一行 crontab 也能实现相同效果,并把预览链接及其问题留在日志中:

0 9 * * 1-5 cd ~/your-repo && claude -p "Draft today's TechFabric post with the techfabric-blog skill." --allowedTools "mcp__techfabric__get_brief mcp__techfabric__lint_draft mcp__techfabric__submit_draft mcp__techfabric__get_status mcp__techfabric__search mcp__techfabric__get_page mcp__techfabric__list_posts Read Grep Glob" >> ~/techfabric-daily-draft.log 2>&1

Codex

一行 crontab 运行 codex exec,在你的计算机上为只读。

curl -fsSL https://www.techfabric.com/mcp-servers/daily-drafts/install.sh | sh -s -- codex

该技能放在 ~/.agents/skills 中,Codex 会在此读取个人技能(0.95 之前的 Codex 则使用 ~/.codex/skills)。然后运行 codex mcp login techfabric 并登录。把以下行添加到你的 crontab,使用你自己代码仓库的路径。该运行在你的计算机上为只读,仅通过 MCP 服务器写入,并把预览链接及其问题留在日志中。

0 9 * * 1-5 cd ~/your-repo && codex exec --sandbox read-only -c 'mcp_servers.techfabric.disabled_tools=["publish_draft","revise_post"]' "Draft today's TechFabric post with the techfabric-blog skill." >> ~/techfabric-daily-draft.log 2>&1

每一个都会安装相同的 techfabric-blog 技能,并按 cron 计划 0 9 * * 1-5 运行,即在你所在时区的每个工作日上午 9 点。请先登录,如设置你的 AI 工具链中所述,以免定时运行在登录处停止。

隐私

TechFabric 的 MCP 服务器会保留你的哪些信息?

阅读不会保留你查询的任何内容。它不需要账户,也不设置 Cookie,唯一存储的是按 IP 统计的调用次数,用于限流。登录写作的作者会留下其草稿和地址。

  • 两个服务器都不会保留你搜索或阅读的内容。一次调用的日志行只记录工具名称和协议版本,绝不记录其参数。
  • 对于匿名调用者,唯一存储的是按 IP 地址统计的调用次数,用于限流,约一小时后过期。
  • 任何读取调用都不会到达我们这边的语言模型。两个服务器都从站点部署时构建的索引中作答,而 Field Guide 的服务器完全不发起任何出站请求。
  • 当 TechFabric 作者登录写作时,服务器会保留其检查、归档或保存的文本,并附上其地址,与浏览器编辑器一样。
  • 隐私政策涵盖站点的其余部分。

常见问题

MCP 服务器:常见问题

什么是 MCP 服务器?

MCP(模型上下文协议)是一个开放标准,用于将 AI 助手连接到其他系统。MCP 服务器会发布一份工具列表及其参数,而 Claude、Codex、Cursor 或 VS Code 的代理模式等助手会在任务进行中调用这些工具,并获得结构化的回答。

像我们这样的远程服务器只是一个 URL,因此连接它只需一行配置,无需安装任何东西。

techfabric.com 的 MCP 服务器是做什么用的?

写作。TechFabric 的工程师使用它,从他们已经在用的编码代理(如 Fabric Agents、Claude Code 或 Codex)起草博客文章和案例研究,并利用该代理已有的仓库和上下文。

代理会运行站点的检查,将草稿归档到工程师的署名下,并在工程师阅读预览并确认后发布。任何人也可以在不登录的情况下搜索和阅读站点已发布的页面。

使用 TechFabric 的 MCP 服务器需要账户吗?

不需要。两个服务器上的所有读取工具都无需登录即可使用,且两个服务器都不设置 Cookie。唯一的登录是在 techfabric.com 的写入工具上,这些工具面向 TechFabric 自己的博客作者,要求使用 techfabric.com 租户中的 Microsoft 账户。

代理能通过 MCP 服务器向 techfabric.com 发布内容吗?

可以,作者自己的代理可以为该作者自己的草稿发布,前提是作者已确认。

publish_draft 要求站点的完整检查已在完全相同的已保存文本上通过,且其首次调用不会发布任何内容:能够询问作者的客户端会询问作者,并指明文章;否则代理会获得一次性确认,并被要求先询问作者再发回。

随后文章会经过编辑器自身的“发布”流程,审批记录会记录作者是如何确认的。不在博客作者列表中的任何人都无法访问写入工具,而 Field Guide 服务器没有发布工具。

我能修改已经发布的文章吗?

可以,如果是你自己的文章。你的代理会用文章的 URL 调用 revise_post,这会打开一个修订版本,其初稿为当前线上文本,并带有自己的预览。

它使用与新草稿相同的工具来编辑、检查并发布该修订版本,发布后会在同一 URL、同一署名下替换线上文章,保留原始日期并添加一行“已更新”。只有文章的作者或博客编辑才能打开修订版本。如果没有代理,请在 techfabric.com/api/ideas/revise 申请“编辑此文章”链接。

Field Guide 服务器是 Databricks 自己的 MCP 服务器吗?

不是。Databricks 在工作区内运行自己的托管 MCP 服务器,这些服务器会对你的数据执行操作,并记录在 docs.databricks.com 上。Field Guide 服务器由 Databricks 合作伙伴 TechFabric 构建和运行。它根据我们的指南回答 Databricks 问题,附带代码和每个章节引用的文档链接,且从不连接到工作区。

Databricks Field Guide 服务器的内容有多新?

其索引在指南每次部署时重建,因此新的边注或重写的章节会在该部署上线后立即出现在服务器的回答中。

每个回答都带有构建它的提交、每个页面的最后更改时间,以及客户端可缓存多长时间。对于确切的语法和限制,请遵循它返回的 docs.databricks.com 链接,因为 Databricks 自己的文档才是权威,指南链接到它而不是复制它。

如果我的代理超出速率限制会怎样?

服务器会返回 HTTP 429 和 Retry-After 头,代理可以在该时间后重试。techfabric.com 允许每个 IP 地址每小时 300 次匿名调用。Field Guide 允许每个 IP 地址每分钟 60 次、每小时 300 次。

TechFabric 的 MCP 服务器在官方 MCP Registry 中吗?

两个都在。techfabric.com 列为 com.techfabric/techfabric,Field Guide 列为 com.techfabric.databricks/field-guide,Glama 将两者都列为连接器。浏览注册表的客户端会在这些名称下找到它们,每个名称背后的域名由该域名提供的密钥证明。