Use with Claude Code

The fastest path is native-mcp register (see the register guide). This page covers the underlying claude mcp commands when you want to do it by hand.

Quickest path

native-mcp register claude-code time calculator json
# or, interactively:
native-mcp register

The command shells out to claude mcp add under the hood — same result as the manual form below, just easier to script.

Add a server manually

claude mcp add native-time native-mcp time

The arguments after the binary name are forwarded verbatim, so server-specific flags work the same way:

claude mcp add native-time-paris native-mcp time --default-tz Europe/Paris
claude mcp add native-fs native-mcp filesystem /tmp /home/you/projects
claude mcp add native-shell native-mcp shell --allow ls,grep,find,cat

Inspect

claude mcp list             # all registered servers
claude mcp get native-time  # full config of one entry

Inside a claude session, type /mcp to see live connection status.

Remove

claude mcp remove native-time
# or, in bulk:
native-mcp register --remove claude-code

Project-scoped servers

Use --scope project to write to .mcp.json in the current directory instead of your user config — useful for sharing a server set with collaborators.

claude mcp add --scope project native-time native-mcp time

native-mcp register always writes user-scoped entries (the default for claude mcp add); use claude mcp directly when you need project scope.

Troubleshooting

• native-mcp: command not found — the binary is not on claude's PATH. Either install with PREFIX=/usr/local/bin or pass the absolute path: claude mcp add native-time /home/you/.local/bin/native-mcp time.
• Server appears but tools are missing — restart your claude session. MCP tool lists are fetched on connect.
• /mcp shows "failed" — run native-mcp time directly in a terminal and pipe a tools/list request to confirm the binary works in isolation. See Debug with MCP Inspector for an interactive way to do this.