frontmcp-channels

Use when pushing real-time notifications or events into Claude Code (or another MCP client) sessions, or building two-way chat bridges. Covers channel source types: incoming webhooks (such as GitHub), app error events, agent-completion and job-completion alerts, service connectors, file watchers, and replay buffers; plus two-way conversational bridges connecting WhatsApp, Telegram, Slack, and Discord to a Claude Code session. Triggers: push notifications, real-time alerts, webhook channel, chat bridge, WhatsApp / Telegram / Slack / Discord, agent completion alert, job status notification, error forwarding, server-to-client messaging. The skill for CHANNELS and NOTIFICATIONS.

仓库: agentfront/frontmcp
最近来源活动: 2026年6月7日 15:32
检测到的 SKILL.md 语言: 英语
星标: 147
分支: 6

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

返回搜索返回安装

name	frontmcp-channels
description	Use when pushing real-time notifications or events into Claude Code (or another MCP client) sessions, or building two-way chat bridges. Covers channel source types: incoming webhooks (such as GitHub), app error events, agent-completion and job-completion alerts, service connectors, file watchers, and replay buffers; plus two-way conversational bridges connecting WhatsApp, Telegram, Slack, and Discord to a Claude Code session. Triggers: push notifications, real-time alerts, webhook channel, chat bridge, WhatsApp / Telegram / Slack / Discord, agent completion alert, job status notification, error forwarding, server-to-client messaging. The skill for CHANNELS and NOTIFICATIONS.
when_to_use	Trigger when creating or editing a *.channel.ts file, or building a channel that pushes real-time notifications into a Claude Code session: webhook sources, app / agent / job event alerts, service connectors, file watchers, or a two-way chat bridge (WhatsApp, Telegram, Slack, Discord).
paths	*/.channel.ts
tags	["channels","notifications","claude-code","webhooks","messaging","real-time","two-way"]
category	development
targets	["all"]
bundle	["full"]
priority	8
visibility	both
license	Apache-2.0
metadata	{"docs":"https://code.claude.com/docs/en/channels-reference"}

FrontMCP Channels

Build push-based notification channels that stream real-time events into Claude Code. Channels let your MCP server forward webhooks, application errors, agent completions, job results, and chat messages directly into Claude's context, with optional two-way reply support.

When to Use This Skill

Must Use

You need Claude Code to react to external events (CI failures, monitoring alerts, deploy status)
You are building a chat bridge (WhatsApp, Telegram, Slack, Discord) for Claude Code
You want agents or background jobs to notify Claude Code upon completion

Recommended

You want to forward application errors to Claude for debugging assistance
You need a messaging interface where remote users can interact with Claude via chat platforms

Skip When

You only need standard MCP resource subscriptions (use @Resource with resources/subscribe)
Your client is not Claude Code and does not support experimental['claude/channel']
You need request-response patterns (use @Tool instead)

Decision: Use channels when you need server-initiated push notifications into Claude Code. Use resources when the client pulls data on demand.

Prerequisites

@frontmcp/sdk >= 1.0.0
Basic understanding of @FrontMcp, @App, and @Tool decorators
For webhook sources: HTTP transport (not stdio-only)
For chat bridges: external API credentials (WhatsApp Business API, Telegram Bot Token, etc.)

Steps

Choose your channel source type from the Scenario Routing Table
Create a channel class or function
Register it in your app
Enable channels in @FrontMcp config
Test with Claude Code using --dangerously-load-development-channels

Scenario Routing Table

name	frontmcp-channels
description	Use when pushing real-time notifications or events into Claude Code (or another MCP client) sessions, or building two-way chat bridges. Covers channel source types: incoming webhooks (such as GitHub), app error events, agent-completion and job-completion alerts, service connectors, file watchers, and replay buffers; plus two-way conversational bridges connecting WhatsApp, Telegram, Slack, and Discord to a Claude Code session. Triggers: push notifications, real-time alerts, webhook channel, chat bridge, WhatsApp / Telegram / Slack / Discord, agent completion alert, job status notification, error forwarding, server-to-client messaging. The skill for CHANNELS and NOTIFICATIONS.
when_to_use	Trigger when creating or editing a *.channel.ts file, or building a channel that pushes real-time notifications into a Claude Code session: webhook sources, app / agent / job event alerts, service connectors, file watchers, or a two-way chat bridge (WhatsApp, Telegram, Slack, Discord).
paths	*/.channel.ts
tags	["channels","notifications","claude-code","webhooks","messaging","real-time","two-way"]
category	development
targets	["all"]
bundle	["full"]
priority	8
visibility	both
license	Apache-2.0
metadata	{"docs":"https://code.claude.com/docs/en/channels-reference"}

Pattern	Correct	Incorrect	Why
Meta keys	`meta: { env: 'prod' }`	`meta: { 'my-env': 'prod' }`	Meta keys must be valid identifiers (letters, digits, underscores)
Source naming	`name: 'deploy-alerts'`	`name: 'Deploy Alerts!'`	Channel names should be kebab-case identifiers
Two-way gating	Check sender identity before emitting	Trust room/group membership	Prevent prompt injection from untrusted group members
Error channels	Use `app-event` source with event bus	Poll for errors in a loop	Event bus is push-based and efficient
Manual push	Use `scope.channelNotifications.send()`	Call `pushNotification` on instance directly	Service handles capability filtering

Problem	Cause	Solution
No notifications arrive	Client doesn't support channels	Check client capabilities include `experimental['claude/channel']`
`channel-reply` tool missing	No two-way channels registered	Set `twoWay: true` on at least one channel
Webhook returns 500	`onEvent()` throws	Check channel handler error logs
Duplicate notifications	Multiple sessions subscribed	This is correct behavior -- each session gets its own copy
Events lost on reconnect	Channels are in-memory	Channel state resets on server restart; use persistent sources

Example	Level	Description
`webhook-github`	Basic	Forward GitHub webhook events (PRs, pushes, CI) into Claude Code
`app-errors`	Basic	Forward application errors to Claude Code via the in-process event bus
`agent-notify`	Intermediate	Notify Claude Code when AI agents complete their tasks
`job-completion`	Intermediate	Notify Claude Code when background jobs and workflows complete
`service-connector`	Advanced	Build a persistent service connector that lets Claude send and receive messages through WhatsApp, Telegram, or any messaging API
`file-watcher`	Intermediate	Watch files for changes and notify Claude Code in real-time
`replay-buffer`	Advanced	Buffer channel events so Claude Code receives them when it connects, even if events occurred while offline

Mode	How it works
Filesystem	Read `libs/skills/catalog/frontmcp-channels/` directly from a clone of the catalog repo, or from a published `@frontmcp/skills` install. SKILL.md is the entry point.
`frontmcp` CLI	`frontmcp skills list`, `frontmcp skills read frontmcp-channels`, `frontmcp skills read frontmcp-channels:references/<file>.md`, `frontmcp skills install frontmcp-channels` — no server required.
MCP `skill://`	When a developer mounts this skill into their own FrontMCP server (`@FrontMcp({ skills: [...] })`), the SDK exposes it via SEP-2640 resources: `skill://frontmcp-channels/SKILL.md`, `skill://frontmcp-channels/references/{file}.md`, etc. The server’s `skill://index.json` returns the SEP-2640 discovery document for everything mounted on it.