[docs] mcp server config doesn't work

[csells]

Following along with the docs, I activate from git (which works):

dart pub global activate -s git https://github.com/dart-lang/ai.git \
  --git-path pkgs/dart_mcp_server/

However, the following mcp config doesn't work for me (and this command doesn't work from the CLI either):

{
  "mcpServers": {
    "dart_mcp": {
      "command": "dart",
      "args": [
        "mcp-server",
        "--experimental-mcp-server",
        "--force-roots-fallback"
      ]
    }
  }
}

I have to do the equivalent of this instead (which makes sense to me, since this works from the CLI):

{
  "mcpServers": {
    "dart_mcp": {
      "command": "dart_mcp_server",
      "args": [
        "--force-roots-fallback"
      ]
    }
  }
}

[jakemac53]

You need to be either on the flutter beta channel (latest release) or the dart dev channel (fairly recent release) for this to work

[csells]

To which "this" are you referring? I'm running the latest flutter stable. Is that not supported?

[jakemac53]

By this I mean the dart mcp-server command version. This is the supported way going forward for using the server, but yes it is not in the current flutter stable, although it will be available on the next stable, and is currently available on beta.

You can continue to use the pub global activated path for now though, but its not how we want to tell people to use it generally, because that one can get out of sync with the SDK.

[jakemac53]

We should have a note in the readme about the minimum required versions though.

[jakemac53]

Assuming #165 (comment) was intended for here :).

We will respond to issues for the MCP server on current flutter stable yes, using the pub global activate installation method. And there may be things we can't work around on certain SDK versions.

The golden path going forward is the dart mcp-server command. Once that hits stable, we will be more reluctant to respond to any issues specific to installing via the pub global activate method (although I don't expect there to be much difference and it will likely continue to work).

[jakemac53]

I am going to close as there isn't any open work on our end here, there are some docs landing about MCP configuration as well which should clarify things.