Arke

Open your Phoenix project's mix.exs file and add arke_ai as a dependency. Then fetch the new dependency.

# In mix.exs:
def deps do
  [
    {:arke_ai, "~> 0.1"}
  ]
end

# Then run:
mix deps.get

Add a forward directive in your Phoenix router to mount the ArkeAi MCP router at a path of your choice. Configure authentication mode, the Arke project identifier, and the resources to expose.

# In lib/my_app_web/router.ex:
forward "/mcp", ArkeAi.Mcp.Router,
  auth: :local,
  project: :my_project,
  otp_app: :my_app,
  expose: [
    {:arke, :user, [:list, :get, :search]},
    {:arke, :product, [:list, :get, :create, :update]},
    {:group, :admin_group, [:list_arkes, :get_schema]}
  ]

For production deployments, switch auth to :bearer which enables Guardian JWT verification and per-call permission gating. Local mode restricts access to localhost only.

forward "/mcp", ArkeAi.Mcp.Router,
  auth: :bearer,
  project: :my_project,
  otp_app: :my_app,
  expose: [
    {:arke, :product, [:list, :get, :search, :create, :update, :delete]}
  ]

Start the Phoenix server. The MCP endpoint will be available at the path you configured (e.g. http://localhost:4000/mcp).

mix phx.server

Configure your MCP client to connect to the Phoenix application's MCP endpoint over Streamable HTTP. For Claude Desktop, use the url field pointing to your running server.

{
  "mcpServers": {
    "arke": {
      "type": "streamable-http",
      "url": "http://localhost:4000/mcp"
    }
  }
}