MCP

`MINARA_MICROSOFT_PUBLIC_CLIENT_ID`

Microsoft Entra 공개 클라이언트 앱 ID.

제어 대상: Outlook Mail, Outlook Calendar 및 OneDrive의 로컬 인증 코드 + PKCE 흐름을 활성화합니다.
사용처: src/connectors/microsoft-oauth.ts. 공개 식별자이며 클라이언트 시크릿과 함께 사용하지 않습니다.
설정 시점: 릴리스가 등록된 Minara 공개 클라이언트 ID를 주입하기 전까지 설정합니다.
미설정 시: 설정하지 않으면 Microsoft 연결 버튼이 비활성화됩니다.
형식: loopback 콜백용으로 등록된 Microsoft Entra 앱 UUID.
설정 위치: 사용자 대상 설정 아님

`MCP_SERVERS`

부팅 시 구동할 추가 MCP 서버의 JSON 배열.

제어 대상: 기본 MCP 서버 목록을 사용자가 제공한 세트로 재정의합니다. src/app.ts 를 패치하지 않고 독점 사내 MCP 서버를 연결하는 데 유용합니다.
사용처: src/app.ts.
설정 시점: 에이전트에 노출하려는 MCP 서버(stdio 또는 streamable-HTTP)가 있는 경우입니다.
미설정 시: 아래의 내장 MCP 연결만 사용됩니다.
형식: JSON 배열, 예: [{"name":"defillama","command":"npx","args":["-y","@defillama/mcp"]}] Array<{name:string, command:string, args?:string[]}> 로 파싱되어야 합니다.
설정 위치: 사용자 대상 설정 아님

`DEFILLAMA_API_KEY`

DefiLlama Pro REST API 키.

제어 대상: src/defillama/client.ts 로 DefiLlama REST API 를 치는 typed defillama_* 카테고리 도구를 인증합니다(Pro 호스트 path prefix). 무료 호스트는 키가 없어도 되고 Minara forward 도 가능합니다. tool_search 의 namespace: "cap/defillama" 로 발견 — DefiLlama skill 패키지는 없습니다.
사용처: src/defillama/client.ts 와 src/generated/defillama/catalog.ts 에서 등록되는 defillama_* passthrough 도구.
설정 시점: DefiLlama Pro 계정이 있고 Minara forward 없이 로컬 Pro 한도/엔드포인트를 쓰고 싶을 때.
미설정 시: 로그인 상태면 Pro 호스트 호출은 Minara forward, 아니면 무료 엔드포인트 / web 폴백.
형식: https://defillama.com 에서 발급받는 원시 API 키 (Pro 가입).
설정 위치: 설정 → API 키

`DEFILLAMA_MCP_TOKEN`

DefiLlama 관리형 MCP 토큰 (레거시).

제어 대상: DefiLlama 관리형 MCP 서비스(무료 엔드포인트보다 높은 속도 제한을 가진 유료 등급)를 인증합니다. 위의 DEFILLAMA_API_KEY + 타입 defillama_* 도구로 대체되었으며, 레거시 MCP 연결과의 하위 호환성을 위해서만 유지됩니다.
사용처: DefiLlama MCP 가 연결될 때 src/app.ts.
설정 시점: DefiLlama MCP 접근에 비용을 지불했고 에이전트가 공개 REST API 대신 이를 사용하도록 하려는 경우입니다.
미설정 시: DefiLlama 호출이 타입 defillama_* 도구(DEFILLAMA_API_KEY 가 설정된 경우) 또는 무료 엔드포인트로 폴백합니다.
형식: https://defillama.com 에서 발급받는 불투명 토큰.
설정 위치: 사용자 대상 설정 아님

v1 Minara 백엔드 MCP 서브 에이전트 (tier-3 폴백)

각 URL 은 streamable-HTTP MCP 엔드포인트를 가리킵니다. 설정되어 있고 mcp.json 파일이 없으면 해당 서버가 tier-3 폴백으로 등록됩니다. minara mcp add 로 mcp/servers.json 에 등록해 tool_search 로 발견하는 편이 좋습니다. 모두 선택 사항이며 독립적으로 게이트됩니다 — env 가 없어도 다른 것은 깨지지 않습니다. v1 에서는 <name>-mcp-cloud.xxx/sse 에서 SSE 로 제공되었고, v2 는 streamable-HTTP 를 사용하므로 서버가 해당 트랜스포트를 광고해야 합니다.

`MCP_EVM_RPC_URL`

원시 EVM JSON-RPC 서브 에이전트 엔드포인트.

제어 대상: tier-3 폴백 인벤토리에 evm_rpc MCP 서버를 등록합니다(eth_call, simulate, 원시 로그, 쿼리당 15 스텝 / 240s 타임아웃). minara mcp add 로 mcp/servers.json 에 등록해 tool_search 로 발견하는 편이 좋습니다.
사용처: src/app/mcp.ts tier-3 폴백 전용.
형식: 절대 URL, 끝에 슬래시 없음.
설정 위치: 사용자 대상 설정 아님

`MCP_ETHERSCAN_URL`

Etherscan 스타일 익스플로러 서브 에이전트 엔드포인트.

제어 대상: tier-3 폴백 인벤토리에 etherscan MCP 서버를 등록합니다(60 개 이상의 EVM 체인에 걸친 인덱싱된 tx / log / contract 쿼리). minara mcp add 로 mcp/servers.json 에 등록해 tool_search 로 발견하는 편이 좋습니다.
사용처: src/app/mcp.ts tier-3 폴백 전용.
형식: 절대 URL.
설정 위치: 사용자 대상 설정 아님

`FMP_API_KEY`

Financial Modeling Prep 공개 주식 데이터.

제어 대상: tool_search 의 cap/fmp 네임스페이스에서 발견하는 타입 FMP 도구(fmp_fundamentals / fmp_quotes / fmp_technicals / fmp_news / fmp_macro / fmp_analysts / fmp_calendar / fmp_etf / fmp_sectors / fmp_screener / fmp_sec)입니다. 호출자는 선택한 도구를 tool_describe 로 확인합니다. 전용 FMP Skill 패키지는 없습니다. ⚠ 공개 주식 전용 — 크립토는 범위 밖입니다. BTC/ETH/SOL 현물 쿼리는 market.spot 에 위임됩니다. 크립토 트레저리 주식(MSTR, SBET, COIN)은 주식으로서 범위에 포함됩니다. ⚠ FMP 는 옵션 체인이나 그릭스를 제공하지 않습니다. ⚠ 일부 엔드포인트는 tier 게이트가 있습니다(Starter+) — 예: 배치 쿼트, 전체 DCF 종류, 인트라데이 바, 전체 13F 덤프. 클라이언트는 tier 게이트를 FmpTierGateError(HTTP 402)로 표면화하므로 LLM 은 단일 심볼 / 기본 종류 호출로 폴백할 수 있습니다.
사용처: src/tools/fmp/*.ts 와 src/fmp/client.ts (운영자가 재시작 없이 키를 교체할 수 있도록 매 호출마다 변수를 새로 읽음).
설정 시점: FMP 계정이 있고 cap/fmp 로 공개 주식 데이터를 사용하려는 경우입니다.
미설정 시: FMP 도구가 기능 검색에 표시되지 않으며 호출자는 FMP 데이터 없이 안전하게 저하해야 합니다.
형식: 개발자 대시보드 https://site.financialmodelingprep.com/developer/docs 에서 발급받는 원시 키 문자열(URL 래핑 없음). 가격: https://site.financialmodelingprep.com/developer/docs/pricing (Free 250/day, 약 100 개 샘플 심볼; Starter 10K/day 전체 심볼 커버리지가 실제 시나리오 사용을 위한 권장 최소값).
Migration: 이전에 MCP_FMP_URL=https://financial...?apikey=KEY 를 설정했다면, KEY 부분을 추출하여 대신 FMP_API_KEY=KEY 를 설정하세요. MCP_FMP_URL 과 MCP_FMP_INCLUDE 는 더 이상 읽지 않습니다.
설정 위치: 설정 → API 키

`COIN_METRICS_API_KEY` / `FRED_API_KEY` / `EIA_API_KEY` / `NASDAQ_DATA_LINK_API_KEY` / `ALPHA_VANTAGE_API_KEY` / `TWELVE_DATA_API_KEY` / `MASSIVE_API_KEY`

Factor Research 데이터 제공자 인증 정보.

제어 대상: Factor Research 가 특정 시점의 시장 및 경제 데이터를 확인할 때 Coin Metrics, FRED / ALFRED, EIA, Nasdaq Data Link, Alpha Vantage, Twelve Data, Massive 의 인증된 접근을 활성화합니다.
사용처: src/strategy-studio/factor-research/default-data-sources.ts 가 저장된 인증 정보 확인기를 통해 사용합니다.
설정 시점: 연구 워크스페이스에서 사용할 수 있는 제공자의 키만 설정합니다.
미설정 시: 설정되지 않은 인증 제공자는 건너뜁니다. 요청을 충족할 수 있으면 Coin Metrics 커뮤니티 데이터는 키 없이도 사용할 수 있습니다.
형식: 각 제공자 대시보드에서 발급한 원시 API 키.
설정 위치: 설정 → API 키

`SEC_USER_AGENT`

네이티브 SEC EDGAR 데이터 접근을 위한 선언된 신원.

제어 대상: 제공자 중립 시점(point-in-time) 재무 스냅샷 서비스가 data.sec.gov submissions + companyfacts 및 www.sec.gov ticker/CIK 매핑을 호출할 수 있게 합니다. SEC 는 Fair Access 정책에 따라 자동화 클라이언트가 제품과 연락 가능한 연락처를 식별하도록 요구합니다.
사용처: src/capability/sec-edgar-client.ts 및 Institution PIT 펀더멘털 프리플라이트. 이는 API 키나 시크릿이 아닙니다.
설정 시점: PIT_FINANCIAL_SNAPSHOT_MODE 가 shadow 또는 enforce 일 때 필요합니다.
미설정 시: PIT 서비스가 연결되지 않은 채로 남으며, 모드 기본 설정이 shadow 임에도 Institution 은 레거시 펀더멘털 경로를 유지합니다.
형식: "ProductName [email protected]". 가짜 연락처를 사용하지 마세요.
설정 위치: 사용자 대상 설정 아님

`PIT_FINANCIAL_SNAPSHOT_MODE`

Institution 시점(point-in-time) 재무 롤아웃.

제어 대상: off 는 레거시 경로를 유지합니다; shadow 는 애널리스트 입력을 바꾸지 않고 SEC 기반 스냅샷을 구축·영속합니다; enforce 는 스냅샷을 도구 없는 Fundamentals 애널리스트에 공급하고 분석 캐싱을 활성화합니다.
사용처: 런타임 Preferences 스키마의 data.pitFinancialSnapshots.mode 및 src/app/institution.ts. 변경하려면 에이전트 재시작이 필요합니다.
기본값: shadow. 허용 값: off | shadow | enforce.
설정 위치: 설정 → 환경설정 (schema 키)

`MCP_SOLSCAN_URL`

Solscan 호환 Solana 익스플로러 서브 에이전트.

제어 대상: tier-3 폴백 인벤토리에 solscan MCP 서버를 등록합니다(인덱싱된 Solana 쿼리: SPL transfer, program 호출, 계정 이력). minara mcp add 로 mcp/servers.json 에 등록해 tool_search 로 발견하는 편이 좋습니다.
사용처: src/app/mcp.ts tier-3 폴백 전용.
형식: 절대 URL.
설정 위치: 사용자 대상 설정 아님

`MCP_GOPLUS_URL`

GoPlus 멀티체인 Web3 보안 분석.

제어 대상: tier-3 폴백 인벤토리에 goplus MCP 서버를 등록합니다(토큰 허니팟 검사, approval 위험, 주소 평판). minara mcp add 로 mcp/servers.json 에 등록해 tool_search 로 발견하는 편이 좋습니다. 일반 체인에 대한 GoPlus 보안 커버리지는 이 환경 변수 없이도 내장 security.token 스킬로 이미 제공됩니다.
사용처: src/app/mcp.ts tier-3 폴백 전용.
형식: 절대 URL.
설정 위치: 사용자 대상 설정 아님

목차