把 Aion 装进你的助手
Aion Vibes 提供一个 MCP 服务器:连接 Claude——或任何使用同一协议的客户端——然后搜索活动、报名、关注社群。绑定账号后,还能创建并发布你自己的活动之夜。全程无需打开网站。
一半的工具不需要账号。
搜索活动、查看详情、报名和关注社群,只要添加服务器就能用:报名会通过邮件发送二维码和钱包链接,无需任何人先注册。账号是用来创建和发布的——也就是代表某人行事。
四步完成连接
- 1
添加服务器
在你的 MCP 客户端里填入这个地址。不需要密钥:客户端会自行注册。
claude mcp add --transport http aion https://api.aionvibes.com/mcp/ - 2
在浏览器中授权
客户端会打开 Aion 的一个页面,上面写明是哪个客户端在请求访问,以及它能做什么。用 Google 或邮箱登录,然后点击授权。
- 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
提问
“在 10 月 15 日于布雷西亚发布一场关于 Local AI vs Cloud AI 的活动,配一张夜间风格的封面”——这句话会变成一份草稿、一张封面和一个上线的活动。
你的凭证会经历什么
客户端里没有密码。 连接通过 OAuth 2.1 完成:你在 aionvibes.com 登录,客户端会收到一个只对它本身有效的令牌。
必须使用 PKCE。 返回给客户端的授权码本身不足以换取令牌:还需要客户端自己保留的密钥,这个密钥从未经过浏览器。
只能用一次。 授权码和刷新令牌一经使用即失效。访问令牌有效期一小时,会自动续期;如果你停止使用,连接会在三十天后过期。
只有你的权限,不多不少。 客户端以你的身份行事:只能看到你管理的社群,仅此而已。平台数据分析只对管理员账号开放。
工具
查找
无需账号现在有什么活动,在哪里。即使从没接触过 Aion 的人也能用。
find_events按城市、日期范围、分类或自由文本搜索。
也包含从其他平台抓取的信息,会标注来源:这些会跳转到源链接打开,不能在这里预订。
get_event一场活动的详情:时间、地点、价格、容量。
也会说明报名是即时通过,还是需要组织者审核。
list_event_categories各个分类,带 slug 和颜色。
list_citiesAion 的活动分布在哪里,各有多少场。
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.