Tela

远程服务

telawiki.com记忆与知识882 周前更新

关于 Tela

Tela 是可自托管的 Markdown 原生团队 Wiki，内置 MCP 服务，供 Agent 搜索、读取和写入 Wiki 页面。tela-mcp 是一个 npm 包，作为 stdio 与 HTTP 之间的代理，供只支持 stdio 的主机使用。项目采用 AGPL-3.0-only 许可。

主要功能

01内置 MCP 服务，端点为 /api/mcp
02Markdown 原生的 Wiki 页面
03Postgres 全文与语义混合排序搜索
04支持反向链接遍历
05基于个人访问令牌的认证
06读写与管理权限范围由服务端强制

适用场景

01让 Agent 检索和更新团队文档
02为只支持 stdio 的 MCP 主机接入 Tela
03在本地或自有服务器上部署团队知识库

MCP 相关

Tela 后端在 /api/mcp 暴露 MCP 工具、资源和提示词。tela-mcp 仅将完整的 MCP 协议从 stdio 转发到该端点，并注入个人访问令牌。

#wiki #knowledge-base #markdown #documentation #self-hosted #ai-agents

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://telawiki.com/api/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http tela https://telawiki.com/api/mcp

Cursor.cursor/mcp.json{"mcpServers":{"tela":{"type":"http","url":"https://telawiki.com/api/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"tela":{"type":"http","url":"https://telawiki.com/api/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"tela":{"type":"http","url":"https://telawiki.com/api/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"tela":{"serverUrl":"https://telawiki.com/api/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npmtela-mcp0.7.4stdio

工具

详细介绍

tela-mcp

一个针对 Tela 实例内置 MCP 服务的轻量级 stdio↔HTTP 代理。

从 v0.7 开始，MCP 服务位于 Tela 后端内部，地址为 {TELA_BASE_URL}/api/mcp（符合规范的 Streamable HTTP）。此 npm 包不再自行实现任何工具，只是一个简单的管道，通过 stdio 将完整的 MCP 协议（工具、资源、提示词、通知）转发到该端点，并注入你的个人访问令牌作为 bearer 标头。由于它不掌握任何工具信息，后端的 MCP 功能可以持续扩展，而无需修改此包——也就没有第二套实现会逐渐偏离。

大多数宿主不需要此包

现代 MCP 宿主可直接使用 Streamable HTTP 传输——将它们指向该端点即可，完全跳过代理：

# Claude Code
claude mcp add --transport http tela https://telawiki.com/api/mcp \
  --header "Authorization: Bearer tela_pat_..."

Cursor、VS Code、Zed 和 Anthropic Messages API mcp_servers 连接器同样支持 URL + bearer 标头。仅在无法使用 HTTP 传输、只支持 stdio 的宿主中使用此 npm 包。

使用代理（仅支持 stdio 的宿主）

添加到你的 .mcp.json：

{
  "mcpServers": {
    "tela": {
      "command": "npx",
      "args": ["-y", "tela-mcp@latest"],
      "env": {
        "TELA_BASE_URL": "https://telawiki.com",
        "TELA_API_KEY": "tela_pat_..."
      }
    }
  }
}

变量	用途
`TELA_BASE_URL`	Tela 实例的源地址（例如 `https://telawiki.com` 或 `http://localhost:8780`）。代理会连接到 `{TELA_BASE_URL}/api/mcp`。
`TELA_API_KEY`	个人访问令牌（`tela_pat_…`），会作为 `Authorization: Bearer` 转发。在 Settings → API Keys 中创建。

两者都必须在启动时设置，否则进程会在 MCP 握手前以非零状态码退出。

工具和资源目录

工具（list_spaces、get_page、search、semantic_search、 create_page、move_page、add_comment、……）、tela://page/{id} / tela://space/{id} 资源，以及读/写/管理权限范围模型，都在后端定义并记录，而非此处。权限范围和每个空间的限制由服务器端强制执行；失败时，工具结果中会返回常见的 {error, code, status} 封装对象。参见项目 Showcase： https://telawiki.com/spaces/1/pages/19。

身份验证

此包使用静态个人访问令牌（PAT）进行身份验证，可与 Messages API 连接器以及任何支持 bearer 标头的宿主配合使用。Claude.ai / ChatGPT 消费级应用使用的 OAuth“Connect”流程是独立的服务器端功能（不涉及此包）。

开发

cd mcp
npm install
npm run build            # tsc → dist/server.js
npm run test:integration # live proxy↔backend E2E (needs a running backend; use `make test-mcp-integration` from the repo root)

此代理基于官方 @modelcontextprotocol/sdk 传输实现，代码约 40 行。全面的单工具覆盖测试位于 Go 后端的端到端 MCP 测试中（backend/internal/api/mcp_test.go）。