OpenRouter / Open WebUI | 통합

설정

OpenRouter를 OpenAI 호환 연결로 Open WebUI에 연결한 다음, Minds API 키를 Bearer 토큰으로 사용해 Minds를 MCP(Streamable HTTP) 도구 서버로 추가하세요.

OpenRouter를 Open WebUI에 연결하기

1. openrouter.ai/keys에서 API 키를 만드세요.
2. Open WebUI에서 Settings → Admin → Connections를 열고 OpenAI API 연결 아래의 + Add Connection을 클릭하세요.
3. URL: https://openrouter.ai/api/v1. API 키: OpenRouter 키.
4. 원하는 모델 ID를 Model IDs 허용 목록에 추가하세요(예: anthropic/claude-sonnet-5). OpenRouter는 수천 개의 모델을 반환하므로 Open WebUI는 허용 목록과 Cache Base Model List 활성화를 권장합니다(Open WebUI 문서).
5. 저장한 뒤 채팅 모델 선택기에서 OpenRouter 모델을 고르세요.

Minds를 MCP 도구 서버로 Open WebUI에 추가하기

Open WebUI는 v0.6.31부터 MCP를 기본 지원하며, MCP 서버는 관리자만 추가할 수 있습니다(Open WebUI MCP 문서).

1. 설정 → API 키에서 Minds API 키를 생성하세요(형식 minds_…).
2. Open WebUI에서 Settings → Admin → Integrations를 열고 External Tool Servers 아래의 + Add Connection을 클릭하세요.
3. 유형: OpenAPI가 아닌 MCP (Streamable HTTP).
4. URL: https://getminds.ai/mcp.
5. Auth: Bearer를 선택하고 minds_… 키를 붙여넣으세요. 키 없이 Bearer를 선택하면 빈 헤더가 전송되어 서버가 거부합니다.
6. 저장한 뒤 모델이나 채팅에서 Minds 도구를 활성화하세요. 네이티브 도구 호출이 안정적인 모델을 고르세요. 성능이 낮은 모델은 연결이 정상이어도 도구를 무시할 수 있습니다.

OpenRouter API로 Minds 사용하기

모델 제공자(예: OpenRouter를 통한 openai/*)가 서버 측에서 MCP 호출을 실행하면 OAuth 핸드셰이크를 수행할 수 없습니다. 요청은 Authorization 헤더 없이 Minds에 도달해 401을 반환합니다. 대신 정적 headers 필드를 포함한 MCP 서버 디스크립터를 전달하세요:

{
  "type": "mcp",
  "server_label": "minds",
  "server_url": "https://getminds.ai/mcp",
  "headers": {
    "Authorization": "Bearer minds_YOUR_API_KEY"
  }
}

OpenRouter 자체 MCP 서버는 별개입니다

OpenRouter는 https://mcp.openrouter.ai/mcp에서도 MCP 서버를 운영합니다. 코딩 어시스턴트가 OpenRouter 모델, 가격, 크레딧, 문서를 조회하는 용도이며 Minds를 연결하지는 않습니다(OpenRouter MCP 문서).

MCP 서버 URL

https://getminds.ai/mcp

전체 MCP 문서 보기