关于 Talaria
Talaria 是面向编码 Agent 的托管 MCP 服务和 Agent 插件,用于调查生产环境错误、追踪记录和回放。其技能引导工作从配置和观察延伸至问题分诊及发布后的修复验证。
主要功能
- 01生产环境错误与问题调查
- 02追踪、跨度、会话和回放检查
- 03项目健康状况与性能观察
- 04问题分诊技能
- 05发布后的修复验证
- 06OAuth 和个人令牌身份验证
适用场景
- 01查找并调查未解决的生产环境错误
- 02分诊问题时检查追踪记录和回放
- 03发布后验证修复结果
- 04检查项目健康状况与性能
MCP 相关
Talaria 在 `https://api.newtalaria.com/mcp` 提供托管 MCP 工具,使用 Streamable HTTP,并支持 OAuth 2.1 with PKCE 或个人 Bearer 令牌。工具组涵盖问题、事件、性能、分析、标记和运维,也可通过 URL 限定为只读或指定工具组。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.newtalaria.com/mcpclaude mcp add --transport http com-newtalaria-talaria https://api.newtalaria.com/mcp{"mcpServers":{"com-newtalaria-talaria":{"type":"http","url":"https://api.newtalaria.com/mcp"}}}在 Cursor 中打开{"servers":{"com-newtalaria-talaria":{"type":"http","url":"https://api.newtalaria.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-newtalaria-talaria":{"type":"http","url":"https://api.newtalaria.com/mcp"}}}{"mcpServers":{"com-newtalaria-talaria":{"serverUrl":"https://api.newtalaria.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Talaria Agent 插件
托管的 Talaria MCP 服务和技能,供编码 Agent(Copilot、VS Code、Claude Code、Gemini CLI、Cursor、Grok)调查生产环境中的错误、追踪记录和回放,然后对问题进行分诊,并在发布后验证修复。
MCP: https://api.newtalaria.com/mcp(Streamable HTTP,使用 PKCE 的 OAuth 2.1)
此插件不包含任何密钥。Agent 通过 OAuth 登录(或使用 Settings → Integrations 中的个人 Bearer 令牌)。切勿使用摄取密钥(tal_live_…)——/mcp 会拒绝此类密钥。
安装
Grok Bot(Connect apps)
- 在 Grok Bot 中打开 Connect apps。
- 等待市场列表获批后,搜索 Talaria(句柄
talaria)——或添加名为Talaria的自定义 MCP 服务,地址为https://api.newtalaria.com/mcp。 - 确认 → 在浏览器中授权 → 选择组织。
- 提出类似这样的问题:“生产环境中尚未解决的错误有哪些?按数量列出。”
设置指南:newtalaria.com/mcp
Cursor
从 cursor.directory/plugins/talaria 安装,或按照 Cursor 设置指南 手动添加 MCP 服务。
skills/ 下的技能会引导你完成入门 → 分诊 → 验证修复。
VS Code / GitHub Copilot
选项 1:通过链接安装(打开 VS Code)
对于 VS Code Insiders,使用此链接。
选项 2:命令行
code --add-mcp '{"name":"talaria","type":"http","url":"https://api.newtalaria.com/mcp"}'
选项 3:MCP Gallery(列出后)
在 Extensions 视图中搜索 @mcp talaria,或运行 MCP: Add Server → Browse MCP Servers…
GitHub Copilot CLI
在 awesome-copilot 中列出后:
copilot plugin install talaria@awesome-copilot
也可以直接从此仓库安装:
copilot plugin install newtalaria/talaria-agent-plugin
Claude Code
步骤 1: 添加可自托管的市场
claude plugin marketplace add newtalaria/talaria-agent-plugin
步骤 2: 安装插件
claude plugin install talaria@newtalaria
Anthropic 目录列表待定。
Gemini CLI
gemini extensions install https://github.com/newtalaria/talaria-agent-plugin
当此仓库添加 gemini-cli-extension 主题后,该扩展会显示在 geminicli.com/extensions 的扩展库中。
Grok Build
在 xai-org/plugin-marketplace 中列出后,按插件名称 talaria 安装(远程来源固定到 SHA)。在此之前,将 Grok Build 指向此仓库的最新提交。
技能
| 技能 | 使用时机 |
|---|---|
talaria-get-started | 连接、确认组织/项目、首次进行冒烟读取 |
talaria-instrument | 添加 Talaria SDK、创建项目/密钥、发送首个测试事件 |
talaria-observe-performance | 读取项目健康状况、追踪记录、跨度、查询、会话、监控项 |
talaria-triage-issue | 调查单个问题(打包 → 追踪记录/回放/疑似原因 → 可选 GitHub) |
talaria-verify-fix | 发布后:获取 verify_fix 判定,可选更新状态 |
闭环:get-started → instrument → observe → triage → verify-fix。
身份验证与权限范围
| 方法 | 说明 |
|---|---|
| OAuth(首选) | 浏览器登录;权限范围为 mcp:read / mcp:write / mcp:keys |
| 个人令牌 | Settings → Integrations;以 Authorization: Bearer … 形式发送 |
写入权限包含读取权限;密钥权限包含写入权限。技能会在使用任何写入工具前征求确认。
不要将 tal_live_… 摄取密钥粘贴到 MCP 客户端中。
MCP URL
| URL | 行为 |
|---|---|
https://api.newtalaria.com/mcp | 你所属的所有组织 |
https://api.newtalaria.com/mcp/<org> | 一个组织 |
https://api.newtalaria.com/mcp/<org>/<project> | 一个项目 |
…?readonly=true | 仅限读取工具 |
…?toolsets=issues,performance | 限定工具组 |
始终启用的工具组:docs、connection。其他工具组:projects、keys、issues、events、performance、analytics、flags、ops。
仓库布局
plugin.json # Agent Plugins 1.0 manifest (VS Code, Copilot CLI, Cursor)
mcp.json # Agent Plugins MCP wiring (type: streamable-http)
.cursor-plugin/plugin.json # Cursor plugin manifest
.grok-plugin/plugin.json # Grok Build style manifest
.claude-plugin/ # Claude Code plugin + self-hosted marketplace
.mcp.json # MCP wiring for Claude Code / Grok Build (type: http)
gemini-extension.json # Gemini CLI extension (httpUrl)
server.json # Official MCP Registry entry
skills/ # Agent skills (closed loop)
assets/logo.png # 512×512 mark on solid plate
LICENSE # MIT · Talaria Labs
链接
- 产品 MCP 页面:https://www.newtalaria.com/mcp
- 文档:https://www.newtalaria.com/docs/mcp
- 隐私:https://www.newtalaria.com/legal/privacy
- 此仓库:https://github.com/newtalaria/talaria-agent-plugin
许可证
MIT © Talaria Labs
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。