MCP

把 Aion 装进你的助手

Aion Vibes 提供一个 MCP 服务器:连接 Claude——或任何使用同一协议的客户端——然后搜索活动、报名、关注社群。绑定账号后,还能创建并发布你自己的活动之夜。全程无需打开网站。

一半的工具不需要账号。

搜索活动、查看详情、报名和关注社群,只要添加服务器就能用:报名会通过邮件发送二维码和钱包链接,无需任何人先注册。账号是用来创建和发布的——也就是代表某人行事。

四步完成连接

  1. 1

    添加服务器

    在你的 MCP 客户端里填入这个地址。不需要密钥:客户端会自行注册。

    claude mcp add --transport http aion https://api.aionvibes.com/mcp/
  2. 2

    在浏览器中授权

    客户端会打开 Aion 的一个页面,上面写明是哪个客户端在请求访问,以及它能做什么。用 Google 或邮箱登录,然后点击授权。

  3. 3

    重新打开终端常见卡点

    Close the window you launched the command from and open a new one. The session you had open loaded the tool list when it started — before the token existed — and will keep not seeing Aion: it's not an error to retry. From a fresh terminal, claude mcp list answers ✔ Connected.

  4. 4

    提问

    “在 10 月 15 日于布雷西亚发布一场关于 Local AI vs Cloud AI 的活动,配一张夜间风格的封面”——这句话会变成一份草稿、一张封面和一个上线的活动。

你的凭证会经历什么

客户端里没有密码。 连接通过 OAuth 2.1 完成:你在 aionvibes.com 登录,客户端会收到一个只对它本身有效的令牌。

必须使用 PKCE。 返回给客户端的授权码本身不足以换取令牌:还需要客户端自己保留的密钥,这个密钥从未经过浏览器。

只能用一次。 授权码和刷新令牌一经使用即失效。访问令牌有效期一小时,会自动续期;如果你停止使用,连接会在三十天后过期。

只有你的权限,不多不少。 客户端以你的身份行事:只能看到你管理的社群,仅此而已。平台数据分析只对管理员账号开放。

工具

查找

无需账号

现在有什么活动,在哪里。即使从没接触过 Aion 的人也能用。

find_events

按城市、日期范围、分类或自由文本搜索。

也包含从其他平台抓取的信息,会标注来源:这些会跳转到源链接打开,不能在这里预订。

get_event

一场活动的详情:时间、地点、价格、容量。

也会说明报名是即时通过,还是需要组织者审核。

list_event_categories

各个分类,带 slug 和颜色。

list_cities

Aion 的活动分布在哪里,各有多少场。

list_featured_communities

谁在持续组织活动。

whats_on_digest

一座城市正在发生什么的摘要,已经精简排序好。

是用来改写成消息、粘贴进群聊的,不是用来浏览的。

参与进来

无需账号

一段对话变成一个报名参加活动的人,就发生在这里。全程不需要账号。

rsvp_to_event

为某人报名:姓名、邮箱,二维码会通过邮件发出。

不用先下载 App,也不用先注册账号。返回结果已经带上了钱包链接,这条报名记录会标记为来自助手。

get_wallet_pass

把票添加到 Apple 或 Google Wallet 的链接。

适合已经报名、又不想翻邮件的人。

follow_community

把某个社群的活动加入你自己日历的链接。

一个 iCalendar 订阅:新活动会自动出现,一直如此,不用安装任何东西。

认领

混合

你的活动是不是已经在这里被收录了?搜索免费,认领需要账号。

find_my_listing无需账号

在收录信息中搜索你的活动,连同它已经积累的关注一起找到。

Aion 上的人已经给这场活动留下的反应和关注——你今天还看不到的这批观众。

claim_listing需要账号

把一条收录信息变成你自己的 Aion 活动,内容已经帮你填好。

名称、地点、日期、描述和封面都来自这条信息。活动以草稿形式创建:价格和容量仍需你自己设置。需要账号。

组织

需要账号

从这里开始,你需要一个已绑定的账号。

list_my_communities

你管理的社群,附带各自的 id。

这是第一步:没有日历的活动不会出现在任何社群页面上。每一行都会说明这是你创建的,还是你替别人管理的。

create_public_event

创建一场活动——标题、时间、地点、价格、容量。

以草稿形式创建:发布之前谁都看不到。

update_public_event

修改一场活动,无论是在发布前还是发布后。

只改动你传入的字段,其余保持原样。

design_event_cover

用活动主题的颜色生成封面。免费。

背后没有模型:不消耗积分,响应即时,同一场活动总是得到同一张图。

generate_event_cover

根据描述生成封面并应用。

需要一个真实场景——一家场地、一个舞台、一道菜。描述的是画面,不是活动本身。消耗积分。

publish_public_event

发布草稿。

从这一步起,地址可以访问,活动也会出现在 Discover 上。

set_event_coupons

活动的优惠码。

写入前会重新读取设置,不会清空报名问题和模板。

get_event_template

一个现成的结构供你填写:快速 RSVP、按人预订、页面模块。

问题之间的字段会互相关联——价格、条件、页面——错填一个,表单看起来正常,用起来却出问题。

set_registration_questions

报名者要填写的问题:类型、价格、条件、页面。

在按人收费的活动里,价格在这里设置,不在票上:总价只会计一次基础费用。

set_page_sections

逐日日程、图库、视频、常见问题、链接。

正是这些让活动页面区别于一张表单。

set_community_sections

同样的模块,只是挂在社群下面。

常见问题描述的是这个社群,放在它的每一场活动上都会是一样的内容:不应该在这里重复。

schedule_event_series

一场周期性活动:一次性设置所有日期。

“每周四,一直到十二月。”这条规则会立刻展开成一场场真实活动,每一场都有自己的页面。

list_my_public_events

你即将举办的活动,或者已经结束的活动。

策划并办好这一夜

需要账号

什么时候办,准备好了没有,怎么把人带进门。

suggest_event_slot

根据那晚这座城市已经有的活动,来选哪一天办。

这个数字来自其他平台的公开信息:它反映的是那一晚真实的竞争情况,而不是我们自己日历有多满。

event_health_check

一场活动在发布前还缺什么。

区分哪些问题会让发布直接失败,哪些只会让读者划过去。

create_tracked_invite

每个渠道一个独立的邀请链接。

代码通过 ref 参数传递,并保留在报名记录上。结果会显示在“管理 › 增长”下的“活动报名”中。

check_in_guest

不用打开扫码器,直接把某人标记为已签到。

接受二维码,或者嘉宾口头念出的短码。同一个人再扫一次不会被重复计数。

衡量

需要账号

进展如何。

event_registrations

有多少人报名、处于什么状态,以及问卷的回答。

platform_analytics

用户、组织者、活动、报名数——与上一周期对比。

仅限管理员账号。

了解

无需账号

某件事怎么运作:一个简短答案,如果有的话,再配上演示视频。全部精心挑选,从不靠搜索。

find_help

讲清楚某个具体场景——第一次办活动、票务、达人资料——如果有对应的视频指南,也会一并附上。

如果那个场景没有对应内容,会直接说明,而不是给一个凑合相近的答案。

find_guides

只给出 Aion 针对某个具体场景的视频指南。

适合只想看视频的人。

从素材到短视频

需要账号

一晚拍摄的素材会变成待审核发布的竖版短片。繁重的工作——色调映射、剪辑、渲染——都在你自己的电脑上完成:这些工具就是它领取任务、交回结果的方式。

list_content_projects

一场活动的视频项目,以及每一个的进度。

content_project_status

录制内容、完成或失败的步骤、等待通过的短片。

claim_content_job

领取下一个要在这台设备上运行的任务。

两台设备不会领取同一个任务,中途宕机的设备会自动把任务交还。

content_job_heartbeat

表示任务仍在进行中。

content_upload_url

输出内容的上传位置:代理文件、音频、短视频、封面。

complete_content_job

提交结果,推动项目进入下一步。

fail_content_job

退回失败的任务,并给出原因。

review_content_clip

通过提议的短片——将其加入渲染队列——或者丢弃。

审核时可以修改标题、开场白和字幕。调整时间点,剪辑会自动重新对齐文字。

publish_content_clip

将渲染完成的短片安排发布到社交渠道。

已经发到某个渠道的短片,不会被重复发送。

面向集成方

可流式传输的 HTTP 端点为 https://api.aionvibes.com/mcp/。不带 Authorization 头也能连接成功,开放工具会正常响应;受限工具则返回一个说明如何连接的错误,而不是传输错误。

带有但无效的 Authorization 头会收到 401,其中 WWW-Authenticate 头指向资源元数据:客户端正是由此自行发现授权服务器。

GET  /.well-known/oauth-protected-resource
GET  /.well-known/oauth-authorization-server
POST /oauth/register    动态注册(RFC 7591)
GET  /oauth/authorize   必须使用 PKCE S256
POST /oauth/token       authorization_code | refresh_token

客户端是公开的:没有需要保管的 client_secret。撑起整个流程的是 PKCE。

哪里不对劲?写信给我们,akaion@akaion.com.