Avo for Rails MCP Server (avo-mcp_server)

Avo MCP：將 Rails 應用程式的 Avo 資源、動作和 Pundit 政策提供給 AI 代理，讓每個代理只能查看和變更使用者角色允許的內容。Avo 4.2+ 的付費附加元件（每月 $30）；透過 OAuth 在應用程式內以 HTTP 執行。

GitHub

文件

Avo MCP Server

Let your team ask Claude, ChatGPT, Cursor or Codex about the data in your Rails app, in plain words. avo-mcp_server serves your Avo app as a remote MCP server. Each client acts as the person who connected it, through the same resources, Pundit policies and field visibility your Avo app already applies to them.

Product page: https://avohq.io/addons/mcp
Docs: https://docs.avohq.io/4.0/mcp.html
Pricing: https://avohq.io/pricing

This repository holds the README only. The gem is a commercial Avo add-on, served from Avo's private gem source to licensed apps.

What your agents get

Ten tools, scoped to what the connecting admin may see and do:

Read	Write	Actions
`list_resources`, `list_records`, `count_records`, `show_record`, `search_records`	`create_record`, `update_record`, `delete_record`	`list_actions`, `run_action`

Add your own with config.mcp_server.extra_tools.

Remote over HTTPS, with OAuth. A teammate pastes the URL into their client and approves a consent screen served by your app. No token to paste, no stdio process.
Per-connection grants. Each connection gets read, write or actions, optionally narrowed to some resources, and can be revoked from the admin.
A log on every connection. Every call a connection makes is recorded on its page.
Rate limited. 300 tool calls a minute per connection by default.

Works with Claude Code, Codex CLI, Cursor, Amp, VS Code, and ChatGPT in developer mode: any client that supports remote MCP servers with OAuth.

Install

Requires Avo 4.2 or newer, and a license with the MCP Server and Authorization add-ons. Your app must be reachable over public HTTPS.

# Gemfile
gem "avo-mcp_server", source: "https://packager.dev/avo-hq/"

bundle install
bin/rails generate avo:mcp_server install
bin/rails db:migrate

# config/routes.rb
Rails.application.routes.draw do
  mount_avo_mcp_server # outside your authentication block, before mount_avo

  authenticate :user do
    mount_avo
  end
end

# config/initializers/avo.rb
Avo.configure do |config|
  config.mcp_server.enabled = true
end

Your server answers at https://your-app.com/avo/mcp. The docs cover each client, grants, the log and custom tools.

Pricing

The MCP Server add-on is $30 a month per app and needs Authorization ($40 a month). Both are included in the AI Bundle and the Everything bundle. Unlimited users. See https://avohq.io/pricing.

Support

Questions: hi@avohq.io. Security reports: https://avohq.io/security.